DSC-Ressource „WindowsProcess“
Gilt für: Windows PowerShell 4.0, Windows PowerShell 5.x
Die Ressource WindowsProcess in Windows PowerShell DSC bietet einen Mechanismus zum Konfigurieren von Prozessen auf einem Zielknoten.
Hinweis
In dieser Dokumentation dieser DSC-Ressource wird die Version behandelt, die in PowerShell vor Version 7.2 enthalten ist. Das PSDscResources-Modul enthält neue und aktualisierte DSC-Ressourcen, die offiziell von Microsoft unterstützt werden. Das Modul PSDscResources ist im PowerShell-Katalog verfügbar.
Weitere Informationen und aktualisierte Dokumentation finden Sie in der PSDscResources-Referenzdokumentation.
Syntax
WindowsProcess [string] #ResourceName
{
Arguments = [string]
Path = [string]
[ Credential = [PSCredential] ]
[ StandardErrorPath = [string] ]
[ StandardInputPath = [string] ]
[ StandardOutputPath = [string] ]
[ WorkingDirectory = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Eigenschaften
Eigenschaft | BESCHREIBUNG |
---|---|
Argumente | Gibt eine Zeichenfolge von Argumenten an, die wie vorhanden an den Prozess übergeben wird. Wenn Sie mehrere Argumente übergeben müssen, fügen Sie sie alle dieser Zeichenfolge hinzu. |
Pfad | Der Pfad zur ausführbaren Prozessdatei. Wenn es sich um den Namen der ausführbaren Datei (keinen vollqualifizierten Pfad) handelt, durchsucht die Ressource „DSC“ die Umgebungsvariable $env:Path , um die ausführbare Datei zu ermitteln. Wenn der Werte dieser Eigenschaft ein vollqualifizierter Pfad ist, verwendet DSC nicht die Umgebungsvariable $env:Path , um die Dateien zu finden, und löst einen Fehler aus, wenn der Pfad nicht vorhanden ist. Relative Pfade sind nicht zulässig. |
Anmeldeinformationen | Gibt die Anmeldeinformationen zum Starten des Prozesses an. |
StandardErrorPath | Gibt den Verzeichnispfad an, in den der Standardfehler geschrieben wird. Eine vorhandene Datei wird überschrieben. |
StandardInputPath | Gibt den Standardpfad für die Eingabe an. |
StandardOutputPath | Gibt den Speicherort an, in den die Standardausgabe geschrieben wird. Eine vorhandene Datei wird überschrieben. |
WorkingDirectory | Gibt den Speicherort an, der als das aktuelle Arbeitsverzeichnis für den Prozess verwendet wird. |
Allgemeine Eigenschaften
Eigenschaft | BESCHREIBUNG |
---|---|
DependsOn | Gibt an, dass die Konfiguration einer anderen Ressource ausgeführt werden muss, bevor diese Ressource konfiguriert wird. Wenn beispielsweise die ID des Skriptblocks mit der Ressourcenkonfiguration, den Sie zuerst ausführen möchten, „ResourceName“ und dessen Typ „ResourceType“ ist, lautet die Syntax für das Verwenden dieser Eigenschaft DependsOn = "[ResourceType]ResourceName" . |
Ensure | Gibt an, ob der Prozess vorhanden ist. Legen Sie diese Eigenschaft auf Present fest, um sicherzustellen, dass der Prozess vorhanden ist. Andernfalls legen Sie ihn auf Absent fest. Der Standardwert ist Present. |
PsDscRunAsCredential | Legt die Anmeldeinformationen für die Ausführung der gesamten Ressource fest. |