New-Service

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie New-Service cmdlet tworzy nowy wpis dla usługi systemu Windows w rejestrze i w bazie danych usługi. Nowa usługa wymaga pliku wykonywalnego uruchamianego podczas usługi.

Parametry tego polecenia cmdlet umożliwiają ustawienie nazwy wyświetlanej, opisu, typu uruchomienia i zależności usługi.

Przykłady

Przykład 1. Tworzenie usługi

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

To polecenie tworzy usługę o nazwie TestService.

Przykład 2. Tworzenie usługi zawierającej opis, typ uruchomienia i nazwę wyświetlaną

$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

To polecenie tworzy usługę o nazwie TestService. Używa parametrów New-Service , aby określić opis, typ uruchomienia i nazwę wyświetlaną nowej usługi.

Przykład 3. Wyświetlanie nowej usługi

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

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

To polecenie służy Get-CimInstance do pobierania obiektu Win32_Service dla nowej usługi. Ten obiekt zawiera tryb uruchamiania i opis usługi.

Przykład 4. Ustawianie klasy SecurityDescriptor usługi podczas tworzenia.

W tym przykładzie dodano deskryptor zabezpieczeń tworzonej usługi.

$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

Element SecurityDescriptor jest przechowywany w zmiennej $SDDLToSet . Parametr SecurityDescriptorSddl służy $SDDL do ustawiania klasy SecurityDescriptor nowej usługi.

Parametry

-BinaryPathName

-Confirm

-Credential

-DependsOn

-Description

-DisplayName

-Name

-SecurityDescriptorSddl

-StartupType

-WhatIf

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

ServiceController

To polecenie cmdlet zwraca obiekt reprezentujący nową usługę.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach windows.

Aby uruchomić to polecenie cmdlet, uruchom program PowerShell przy użyciu opcji Uruchom jako administrator .

Linki powiązane

• Get-Service
• Restart-Service
• Resume-Service
• Set-Service
• Start-Service
• Stop-Service
• Suspend-Service
• Remove-Service