PackageDeployment Modul Hilfe
|
Package Deployment Module (DSM eScript Commands)
|
Install-Win32Service Cmdlet
|
Version 1.0.0.3
|
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 mit DSM Runtime Service Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer. Computer: Ausführung mit DSM Runtime Service; 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".
|