Delen via

New-Service

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee maakt u een nieuwe Windows-service.

Syntaxis

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De New-Service cmdlet maakt een nieuwe vermelding voor een Windows-service in het register en in de servicedatabase. Voor een nieuwe service is een uitvoerbaar bestand vereist dat wordt uitgevoerd tijdens de service.

Met de parameters van deze cmdlet kunt u de weergavenaam, beschrijving, opstarttype en afhankelijkheden van de service instellen.

Voorbeelden

Voorbeeld 1: Een service maken

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

Met deze opdracht maakt u een service met de naam TestService.

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

Met deze opdracht maakt u een service met de naam TestService. Hierbij worden de parameters gebruikt voor het opgeven van New-Service een beschrijving, opstarttype en weergavenaam voor de nieuwe service.

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

Met deze opdracht Get-CimInstance wordt het Win32_Service-object voor de nieuwe service opgehaald. Dit object bevat de startmodus en de servicebeschrijving.

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

In dit voorbeeld wordt de SecurityDescriptor toegevoegd van de service die wordt gemaakt.

$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

De SecurityDescriptor wordt opgeslagen in de $SDDLToSet variabele. De parameter SecurityDescriptorSddl gebruikt $SDDL om de SecurityDescriptor van de nieuwe service in te stellen.

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. Moet bijvoorbeeld d:\my share\myservice.exe 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 van de CreateServiceW-API voor meer informatie.

Type:String
Aliassen:Path
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het account op dat door de service wordt gebruikt als het serviceaanmeldingsaccount.

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 SecureString.

Notitie

Zie Hoe veilig is SecureString SecureString?voor meer informatie over SecureString-gegevensbeveiliging.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-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.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving van de service.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u een weergavenaam voor de service op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

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

Type:String
Aliassen:ServiceName
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SecurityDescriptorSddl

Hiermee geeft u de SecurityDescriptor voor de service in Sddl-indeling .

Type:String
Aliassen:sd
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StartupType

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

  • Automatisch : de service wordt gestart of 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 gestart.
  • 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.
  • Handmatig : de service wordt alleen handmatig gestart door een gebruiker, met behulp van Service Control Manager of door een toepassing.

De standaardwaarde is Automatisch.

Type:ServiceStartupType
Geaccepteerde waarden:Automatic, Manual, Disabled, AutomaticDelayedStart, InvalidValue
Position:Named
Default value:Automatic
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

ServiceController

Met deze cmdlet wordt een object geretourneerd dat de nieuwe service vertegenwoordigt.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

Als u deze cmdlet wilt uitvoeren, start u PowerShell met behulp van de optie Als administrator uitvoeren.