ProcessSet

  • Artikel

Übersicht

Verwalten sie mehrere Windows-Prozesse mit allgemeinen Einstellungen.

Syntax

ProcessSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Path = [String[]]
    [Ensure = [String]]
    [Credential = [PSCredential]]
    [StandardOutputPath = [String]]
    [StandardErrorPath = [String]]
    [StandardInputPath = [String]]
    [WorkingDirectory = [String]]
}

BESCHREIBUNG

Mit der ProcessSet zusammengesetzten Ressource können Sie mehrere Windows-Prozesse mit einer begrenzten Gruppe allgemeiner Optionen konfigurieren. Verwenden Sie die WindowsProcess-Ressource, um Prozesse mit mehr Kontrolle zu verwalten, einschließlich der Möglichkeit, Argumente an den Prozess zu übergeben.

Requirements (Anforderungen)

Keine

Schlüsseleigenschaften

Pfad

Geben Sie die Pfade zu ausführbaren Dateien der Prozesse an. Wenn über die PATH Umgebungsvariable auf eine Datei zugegriffen werden kann, können Sie den Namen der Datei angeben. Geben Sie andernfalls den vollständigen Pfad zur Datei an. Relative Pfade werden nicht unterstützt.

Type: System.String[]
Behavior: Key

Optionale Eigenschaften

Anmeldeinformationen

Geben Sie die Anmeldeinformationen des Kontos an, unter dem die Prozesse ausgeführt werden sollen.

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 die Prozesse ausgeführt werden sollen. Legen Sie diese Eigenschaft fest, um die Prozesse zu Present starten, wenn sie nicht ausgeführt werden. Legen Sie diese Eigenschaft fest, um Absent die Prozesse zu beenden, wenn sie ausgeführt werden.

Standardwert: Present.

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

StandardErrorPath

Geben Sie den vollständigen Pfad zu einer Datei für die Prozesse an, in die die Standardfehlerströme geschrieben werden sollen. 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 die Prozesse an, die als Standardeingabedatenstrom gelesen werden sollen. 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 die Prozesse an, in die die Standardausgabedatenströme geschrieben werden sollen. 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 der Prozesse 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 von den Prozessen geöffneten Ziehpunkte.

Type: System.SInt32
Behavior: Read

NonPagedMemorySize

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

Type: System.UInt64
Behavior: Read

PagedMemorySize

Die Menge des seitenseitigen Speichers in Bytes, die den Prozessen zugeordnet sind.

Type: System.UInt64
Behavior: Read

ProcessCount

Die Anzahl der Instanzen der angegebenen Prozesse, die derzeit ausgeführt werden.

Type: System.SInt32
Behavior: Read

ProcessId

Der eindeutige Bezeichner der Prozesse.

Type: System.SInt32
Behavior: Read

VirtualMemorySize

Die Menge des virtuellen Arbeitsspeichers in Bytes, die für die Prozesse zugeordnet sind.

Type: System.UInt64
Behavior: Read

Beispiele