Erstellt einen neuen Windows-Dienst.
Syntax
New-Service [-Name] <string> [-BinaryPathName] <string> [-Credential <PSCredential>] [-DependsOn <string[]>] [-Beschreibung <string>] [-DisplayName <string>] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "New-Service" erstellt einen neuen Eintrag für einen Windows-Dienst in der Registrierung und in der Dienstdatenbank. Für einen neuen Dienst ist eine ausführbare Datei erforderlich, die während des Diensts ausgeführt wird.
Mit den Parametern dieses Cmdlets können Sie den Anzeigenamen, die Beschreibung, den Starttyp und die Abhängigkeiten des Diensts festlegen.
Parameter
-BinaryPathName <string>
Gibt den Pfad zur ausführbaren Datei für den Dienst an. Dieser Parameter ist erforderlich.
|
Erforderlich? |
true |
|
Position? |
2 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Credential <PSCredential>
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01". Oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" zurückgegebenes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-DependsOn <string[]>
Gibt die Namen anderer Dienste an, von denen der neue Dienst abhängt. Trennen Sie zum Eingeben mehrerer Dienstnamen die Namen durch Trennzeichen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
keine |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Beschreibung <string>
Gibt eine Beschreibung des Diensts an.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-DisplayName <string>
Gibt einen Anzeigenamen für den Dienst an.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string>
Gibt den Namen des Diensts an. Dieser Parameter ist erforderlich.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-StartupType <ServiceStartMode>
Legt den Starttyp des Diensts fest. Der Standardwert ist "Automatic".
Gültige Werte:
– Manual: Der Dienst wird nur manuell gestartet, durch einen Benutzer (das Verwenden des Dienststeuerungs-Managers) oder eine Anwendung.
– Automatic: Der Dienst soll beim Systemstart vom Betriebssystem gestartet werden bzw. wurde vom Betriebssystem gestartet. Wenn ein automatisch gestarteter Dienst von einem manuell gestarteten Dienst abhängig ist, wird der manuell gestartete Dienst beim Systemstart ebenfalls automatisch gestartet.
– Disabled: Der Dienst ist deaktiviert und kann nicht von einem Benutzer oder einer Anwendung gestartet werden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
Automatic |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden. |
|
Ausgaben |
System.ServiceProcess.ServiceController New-Service gibt ein Objekt zurück, das den neuen Dienst darstellt. |
Hinweise
Wenn Sie dieses Cmdlet unter Windows Vista und höheren Versionen von Windows ausführen möchten, starten Sie Windows PowerShell mit der Option "Als Administrator ausführen".
Beispiel 1
C:\PS>new-service -name TestService -binaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs" Beschreibung ----------- Mit diesem Befehl wird der neue Dienst "TestService" erstellt.
Beispiel 2
C:\PS>new-service -name TestService -path "C:\WINDOWS\System32\svchost.exe -k netsvcs" -dependson NetLogon -displayName "Test Service" -StartupType Manual -Description "This is a test service." Beschreibung ----------- Mit diesem Befehl wird der neue Dienst "TestService" erstellt. Mit den Parametern des Cmdlets "New-Service" werden Beschreibung, Starttyp und Anzeigename für den neuen Dienst angegeben. Zum Angeben des BinaryPathName-Parameters verwendet der Befehl den Path-Parameteralias. Sie können auch "-bpn" verwenden.
Beispiel 3
C:\PS>get-wmiobject win32_service -filter "name='testservice'" ExitCode : 0 Name : testservice ProcessId : 0 StartMode : Auto State : Stopped Status : OK Beschreibung ----------- Dieser Befehl ruft mit dem Cmdlet "Get-WmiObject" das Win32_Service-Objekt für den neuen Dienst ab. Dieses Objekt enthält den Startmodus und die Dienstbeschreibung.
Siehe auch