New-Service

Syntaxis

Default (Standaard)

New-Service
    [-Name] <String>
    [-BinaryPathName] <String>
    [-DisplayName <String>]
    [-Description <String>]
    [-SecurityDescriptorSddl <String>]
    [-StartupType <ServiceStartupType>]
    [-Credential <PSCredential>]
    [-DependsOn <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Voorbeelden

Voorbeeld 1: Een service maken

New-Service -Name "TestService" -BinaryPathName 'C:\WINDOWS\System32\svchost.exe -k netsvcs'

Voorbeeld 2: Een service maken die een beschrijving, opstarttype en weergavenaam bevat

$params = @{
  Name = "TestService"
  BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
}
New-Service @params

Voorbeeld 3: De nieuwe service weergeven

Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"

ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

Voorbeeld 4: De SecurityDescriptor van een service instellen bij het maken.

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
$params = @{
  BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
  SecurityDescriptorSddl = $SDDL
}
New-Service @params

Parameters

-BinaryPathName

Hiermee geeft u het pad van het uitvoerbare bestand voor de service. Deze parameter is vereist.

Het volledig gekwalificeerde pad naar het binaire servicebestand. Als het pad een spatie bevat, moet het worden geciteerd zodat het correct wordt geïnterpreteerd. D:\my share\myservice.exe moet bijvoorbeeld worden opgegeven als '"D:\my share\myservice.exe"'.

Het pad kan ook argumenten bevatten voor een service voor automatisch starten. Bijvoorbeeld: '"D:\my share\myservice.exe" arg1 arg2'. Deze argumenten worden doorgegeven aan het serviceinvoerpunt.

Zie de parameter lpBinaryPathName parameter van CreateServiceW API voor meer informatie.

Parametereigenschappen

Parametersets

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Parametersets

-Credential

Bepaalt het account dat door de service wordt gebruikt als het service-aanmeldingsaccount .

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential--object in, zoals een object dat is gegenereerd door de Get-Credential-cmdlet. Als u een gebruikersnaam typt, wordt u door deze cmdlet gevraagd om een wachtwoord.

Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als een SecureString.

Parametereigenschappen

Parametersets

-DependsOn

Hiermee geeft u de namen van andere services waarop de nieuwe service afhankelijk is. Als u meerdere servicenamen wilt invoeren, gebruikt u een komma om de namen te scheiden.

Parametereigenschappen

Parametersets

-Description

Hiermee geeft u een beschrijving van de service.

Parametereigenschappen

Parametersets

-DisplayName

Hiermee geeft u een weergavenaam voor de service op.

Parametereigenschappen

Parametersets

-Name

Hiermee geeft u de naam van de service. Deze parameter is vereist.

Parametereigenschappen

Parametersets

-SecurityDescriptorSddl

Specificeert de SecurityDescriptor voor de service in de Sddl-indeling.

Parametereigenschappen

Parametersets

-StartupType

Hiermee stelt u het opstarttype van de service in. De acceptabele waarden voor deze parameter zijn:

• Automatic - De service wordt gestart of is gestart door het besturingssysteem, bij het opstarten van het systeem. Als een automatisch gestarte service afhankelijk is van een handmatig gestarte service, wordt de handmatig gestarte service ook automatisch gestart bij het opstarten van het systeem.
• AutomaticDelayedStart - wordt kort na het opstarten van het systeem uitgevoerd.
• Uitgeschakeld: de service is uitgeschakeld en kan niet worden gestart door een gebruiker of toepassing.
• InvalidValue : deze waarde wordt niet ondersteund. Als u deze waarde gebruikt, resulteert dit in een fout.
• Handmatige: de service wordt alleen handmatig gestart door een gebruiker, met behulp van Service Control Manager of door een toepassing.

De standaardwaarde is Automatisch.

Parametereigenschappen

Parametersets

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

None

Uitvoerwaarden

ServiceController

Notities

Verwante koppelingen

• Get-Service
• Restart-Service
• CV-dienst
• Set-Service
• Start-Service
• Dienst Stoppen
• Dienst Onderbreken
• Verwijder-Service