Install-Win32Service

PackageDeployment Modul Hilfe	Package Deployment Module
Install-Win32Service Cmdlet	Version 3.1.0.0

Install-Win32Service

Übersicht

Dienst installieren

Syntax

Install-Win32Service [-Name] <String> [[-DisplayName] <String>] [[-PathName] <String>] [-ContinueOnError] [-DesktopInteract] [-StartService] [[-LoadOrderGroupAndDependencies] <String>] [[-StartName] <String>] [[-StartPassword] <String>] [[-ServiceTypeAndErrorControl] <String>] [[-StartMode] <String>] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Installiert einen Dienst oder ein Gerät für Windows. Die Installation von Geräten ("devices") wird nicht empfohlen.
Nach Ausführung des Befehls kann es zu einem Neustart des Computers kommen.

Parameter

-Context <String>

User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer.
UserPerService: Benutzerbezogener Befehl, Ausführung im Service-Kontext
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
ComputerPerService: Ausführung im Service-Kontext; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.

Erforderlich	Nein
Position	8
Pipeline-Eingaben akzeptieren	Nein

-ContinueOnError <SwitchParameter>

Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

-DesktopInteract <SwitchParameter>

"Interaktive Beziehung mit Desktop erlauben" legt fest, ob der Dienst auf dem Desktop eine Benutzerschnittstelle anzeigt, die von jedem Benutzer verwendet werden kann, der beim Start des Dienstes angemeldet ist.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

-DisplayName <String>

Der beschreibende Name des Dienstes. Dieser Name wird zum Beispiel im Dienste-Dialog in der Systemsteuerung angezeigt.

Erforderlich	Nein
Position	1
Pipeline-Eingaben akzeptieren	Nein

-LoadOrderGroupAndDependencies <String>

Zusammengesezter Wert aus:
Dienstgruppe
Dienste lassen sich in Gruppen zusammenfassen. Eine Liste der verfügbaren Dienstgruppen findet sich in HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ServiceGroupOrder.
Gruppenabhängigkeit
Die Lauffähigkeit eines Dienstes kann von einer Dienstegruppe abhängig sein. Das bedeutet, dass dieser Dienst erst dann läuft, wenn nach dem Versuch, alle Dienste der Gruppe zu starten, mindestens ein Mitglied der Gruppe läuft.
Dienstabhängigkeit
Die Lauffähigkeit eines Dienstes kann von einem anderen Dienst abhängig sein. Das bedeutet, dass dieser Dienst erst dann läuft, wenn der Dienst, von dem er abhängt, bereits läuft.

Erforderlich	Nein
Position	3
Pipeline-Eingaben akzeptieren	Nein

-Name <String>

Der Name des Dienstes in der Dienstdatenbank. Die Dienstdatenbank befindet sich in der Registry unter HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services.

Erforderlich	Ja
Position	0
Pipeline-Eingaben akzeptieren	Nein

-PathName <String>

Voller Pfad und Dateiname der zum Dienst gehörenden EXE-Datei.

Erforderlich	Nein
Position	2
Pipeline-Eingaben akzeptieren	Nein

-ServiceTypeAndErrorControl <String>

Zusammengesezter Wert aus:
Diensttyp
Ein Bitmuster, das den Diensttyp spezifiziert. Erlaubte Werte sind:
1 (SERVICE_KERNEL_DRIVER)
2 (SERVICE_FILE_SYSTEM_DRIVER)
4 (SERVICE_ADAPTER)
8 (SERVICE_RECOGNIZER_DRIVER)
16 (SERVICE_WIN32_OWN_PROCESS)
32 (SERVICE_WIN32_SHARE_PROCESS)
Detailinformationen zu den Diensttypen finden Sie in MSDN (CreateService).
Wenn Sie entweder 16 oder 32 angeben, und der Dienst unter dem lokalen Systemkonto läuft, können Sie den folgenden Wert zusätzlich angeben, indem Sie ihn dazuaddieren: 256 (SERVICE_INTERACTIVE_PROCESS). Beispiel: 16+256=272
ErrorControl
Spezifiziert das Verhalten im Fehlerfall während der Dienst-Startphase.

Erforderlich	Nein
Position	6
Pipeline-Eingaben akzeptieren	Nein

-StartMode <String>

Boot: Startet den Dienst beim Einschalten des Computers.
System: Startet den Dienst beim Systemstart nach den Diensten der Startart Neustart.
Automatic: Startet den Dienst beim Systemstart automatisch, nachdem die Dienste der Startart Neustart und System gestartet wurden.
Manual: Ermöglicht das Starten des Dienstes durch einen Benutzer oder einen abhängigen Dienst.
Disabled: Verhindert das Starten des Dienstes durch einen Benutzer. Er kann jedoch durch das System gestartet werden.

Erforderlich	Nein
Position	7
Pipeline-Eingaben akzeptieren	Nein

-StartName <String>

Legt fest, ob Dienste sich unter Verwendung des Systemkontos oder eines Benutzerkontos anmelden. Die meisten Dienste melden sich unter Verwendung eines Systemkontos an.
Leere Zeichenfolge = Systemkonto = Legt fest, dass der Dienst sich unter Verwendung des Systemkontos anmeldet.
Domäne\UserID = Dieses Konto = Ermöglicht Ihnen, einem Dienst ein bestimmtes Benutzerkonto zuzuweisen. Die Angabe erfolgt nach der Syntax Domäne\UserID.

Erforderlich	Nein
Position	4
Pipeline-Eingaben akzeptieren	Nein

-StartPassword <String>

Das Kennwort für das Benutzerkonto. Beachten Sie, dass bei Kennwörtern zwischen Groß- und Kleinschreibung unterschieden wird.

Erforderlich	Nein
Position	5
Pipeline-Eingaben akzeptieren	Nein

-StartService <SwitchParameter>

Dadurch wird der Dienst unmittelbar nach der Installation gestartet. Die Verwendung des Befehls StartService ist dann überflüssig.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters".