WindowsProcess

  • Artikel

Übersicht

Starten oder Beenden eines Windows-Prozesses

Syntax

WindowsProcess [String] #ResourceName
{
    Arguments = [string]
    Path = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [PsDscRunAsCredential = [PSCredential]]
    [StandardErrorPath = [string]]
    [StandardInputPath = [string]]
    [StandardOutputPath = [string]]
    [WorkingDirectory = [string]]
}

BESCHREIBUNG

Mit der WindowsProcess Ressource können Sie sicherstellen, ob ein Prozess ausgeführt wird.

Requirements (Anforderungen)

Keine

Schlüsseleigenschaften

Argumente

Geben Sie die vollständige Liste der Argumente an, die beim Starten als Zeichenfolge an den Prozess übergeben werden sollen. Legen Sie diese Eigenschaft auf eine leere Zeichenfolge ('') fest, wenn der Prozess keine Argumente erfordert.

Type: System.String

Pfad

Geben Sie den Pfad zur ausführbaren Datei des Prozesses an. Wenn auf die Datei über die PATH Umgebungsvariable zugegriffen werden kann, können Sie diese Eigenschaft auf den Namen der ausführbaren Datei festlegen. Legen Sie andernfalls diese Eigenschaft auf den vollständigen Pfad der Datei fest. Relative Pfade werden nicht unterstützt.

Type: System.String

Optionale Eigenschaften

Anmeldeinformationen

Geben Sie die Anmeldeinformationen des Kontos an, unter dem der Prozess ausgeführt werden soll.

Wenn diese Eigenschaft auf ein lokales Systemkonto festgelegt ist, können Sie die Eigenschaften StandardOutputPath, StandardInputPath oder WorkingDirectory nicht festlegen. Wenn Sie dies tun, löst die Ressource eine ungültige Argument-Ausnahme aus.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Geben Sie an, ob der Prozess ausgeführt werden soll. Legen Sie diese Eigenschaft fest, um Present den Prozess zu starten, wenn er nicht ausgeführt wird. Legen Sie diese Eigenschaft fest, um Absent den Prozess zu beenden, wenn er ausgeführt wird.

Standardwert: Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

StandardErrorPath

Geben Sie den vollständigen Pfad zu einer Datei für den Prozess an, in den der Standardfehlerdatenstrom geschrieben werden soll. Relative Pfade werden nicht unterstützt. Wenn die Datei vorhanden ist, wird sie überschrieben.

Legen Sie diese Eigenschaft nicht fest, wenn Sie die "Ensure "-Eigenschaft auf Absentfestlegen. Wenn Sie dies tun, löst die Ressource eine ungültige Argument-Ausnahme aus.

Type: System.String
Default Value: None

StandardInputPath

Geben Sie den vollständigen Pfad zu einer Datei für den Prozess an, der als Standardeingabedatenstrom gelesen werden soll. Relative Pfade werden nicht unterstützt.

Legen Sie diese Eigenschaft nicht fest, wenn Sie die Eigenschaft "Ensure " Absent oder die Credential-Eigenschaft auf ein lokales Systemkonto festlegen. Wenn Sie dies tun, löst die Ressource eine ungültige Argument-Ausnahme aus.

Type: System.String
Default Value: None

StandardOutputPath

Geben Sie den vollständigen Pfad zu einer Datei für den Prozess an, in den der Standardausgabedatenstrom geschrieben werden soll. Relative Pfade werden nicht unterstützt. Wenn die Datei vorhanden ist, wird sie überschrieben.

Legen Sie diese Eigenschaft nicht fest, wenn Sie die Eigenschaft "Ensure " Absent oder die Credential-Eigenschaft auf ein lokales Systemkonto festlegen. Wenn Sie dies tun, löst die Ressource eine ungültige Argument-Ausnahme aus.

Type: System.String
Default Value: None

WorkingDirectory

Geben Sie den vollständigen Pfad zu einem Ordner für das Arbeitsverzeichnis des Prozesses an. Relative Pfade werden nicht unterstützt.

Legen Sie diese Eigenschaft nicht fest, wenn Sie die Eigenschaft "Ensure " Absent oder die Credential-Eigenschaft auf ein lokales Systemkonto festlegen. Wenn Sie dies tun, löst die Ressource eine ungültige Argument-Ausnahme aus.

Type: System.String
Default Value: None

Schreibgeschützte Eigenschaften

HandleCount

Die Anzahl der vom Prozess geöffneten Ziehpunkte.

Type: System.Int32
Behavior: Read

NonPagedMemorySize

Die Menge des nicht seitengebundenen Arbeitsspeichers in Bytes, die für den Prozess zugeordnet sind.

Type: System.UInt64
Behavior: Read

PagedMemorySize

Die Menge des seitenseitigen Speichers in Bytes, die für den Prozess zugeordnet sind.

Type: System.UInt64
Behavior: Read

ProcessCount

Die Anzahl der Instanzen des angegebenen Prozesses, der ausgeführt wird.

Type: System.Int32
Behavior: Read

ProcessId

Der eindeutige Bezeichner des Prozesses.

Type: System.Int32
Behavior: Read

VirtualMemorySize

Die Menge des virtuellen Speichers in Bytes, die für den Prozess zugeordnet sind.

Type: System.UInt64
Behavior: Read

Beispiele