PackageDeployment Modul Hilfe

Package Deployment Module

Install-Win32Service Cmdlet

Version 4.0.0.5

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

<CommonParameters>

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