Udostępnij za pośrednictwem

New-Service

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Tworzy nową usługę systemu Windows.

Składnia

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

Opis

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. Usuwanie usługi

sc.exe delete TestService
# - or -
(Get-CimInstance -Class Win32_Service -Filter "name='TestService'").delete()

W tym przykładzie przedstawiono dwa sposoby usuwania usługi TestService. Pierwsze polecenie używa opcji usuwania .Sc.exe Drugie polecenie używa metody Delete zwracanych Get-CimInstance obiektów Win32_Service.

Parametry

-BinaryPathName

Określa ścieżkę pliku wykonywalnego dla usługi. Ten parametr jest wymagany.

W pełni kwalifikowana ścieżka do pliku binarnego usługi. Jeśli ścieżka zawiera spację, musi być cytowana, aby była poprawnie interpretowana. Na przykład d:\my share\myservice.exe należy określić jako '"d:\my share\myservice.exe"'.

Ścieżka może również zawierać argumenty dla usługi automatycznego uruchamiania. Na przykład '"d:\my share\myservice.exe" arg1 arg2'. Te argumenty są przekazywane do punktu wejścia usługi.

Aby uzyskać więcej informacji, zobacz parametr lpBinaryPathName interfejsu API CreateServiceW .

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Określa konto używane przez usługę jako konto logowania usługi.

Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential, taki jak jeden wygenerowany przez Get-Credential polecenie cmdlet. Jeśli wpiszesz nazwę użytkownika, to polecenie cmdlet wyświetli monit o podanie hasła.

Poświadczenia są przechowywane w obiekcie PSCredential , a hasło jest przechowywane jako secureString.

Uwaga

Aby uzyskać więcej informacji na temat ochrony danych SecureString , zobacz Jak bezpieczny jest protokół SecureString?.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DependsOn

Określa nazwy innych usług, od których zależy nowa usługa. Aby wprowadzić wiele nazw usług, użyj przecinka, aby oddzielić nazwy.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Określa opis usługi.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Określa nazwę wyświetlaną usługi.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę usługi. Ten parametr jest wymagany.

Type:String
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StartupType

Ustawia typ uruchamiania usługi. Dopuszczalne wartości tego parametru to:

  • Automatyczne — usługa została uruchomiona lub została uruchomiona przez system operacyjny podczas uruchamiania systemu. Jeśli automatycznie uruchomiona usługa zależy od usługi uruchomionej ręcznie, usługa uruchomiona ręcznie jest również uruchamiana automatycznie podczas uruchamiania systemu.
  • Wyłączone — usługa jest wyłączona i nie można jej uruchomić przez użytkownika lub aplikację.
  • Ręczne — usługa jest uruchamiana tylko ręcznie, przez użytkownika, przy użyciu Menedżera kontroli usług lub przez aplikację.
  • Rozruch — wskazuje, że usługa jest sterownikiem urządzenia uruchomionym przez moduł ładujący systemu. Ta wartość jest prawidłowa tylko dla sterowników urządzeń.
  • System — wskazuje, że usługa jest sterownikiem urządzenia uruchomionym przez funkcję "IOInitSystem()". Ta wartość jest prawidłowa tylko dla sterowników urządzeń.

Wartość domyślna to Automatycznie.

Type:ServiceStartMode
Accepted values:Boot, System, Automatic, Manual, Disabled
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

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

Aby usunąć usługę, użyj Sc.exe lub użyj Get-CimInstance polecenia cmdlet , aby uzyskać obiekt Win32_Service reprezentujący usługę, a następnie użyć metody Delete , aby usunąć usługę. Obiekt, który Get-Service zwraca, nie ma metody delete.