ProcessSet

Streszczenie

Zarządzanie wieloma procesami systemu Windows za pomocą typowych ustawień.

Składnia

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

Opis

Zasób ProcessSet złożony umożliwia skonfigurowanie wielu procesów systemu Windows przy użyciu ograniczonego zestawu typowych opcji. Aby zarządzać procesami z większą kontrolą, w tym możliwość przekazywania argumentów do procesu, użyj zasobu WindowsProcess.

Wymagania

Brak.

Kluczowe właściwości

Ścieżka

Określ ścieżki do plików wykonywalnych procesów. Jeśli plik jest dostępny za pośrednictwem zmiennej PATH środowiskowej, możesz określić nazwę pliku. W przeciwnym razie określ pełną ścieżkę do pliku. Ścieżki względne nie są obsługiwane.

Type: System.String[]
Behavior: Key

Właściwości opcjonalne

Poświadczenie

Określ poświadczenia konta, w ramach których będą uruchamiane procesy.

Jeśli ta właściwość jest ustawiona na lokalne konto systemowe, nie można ustawić właściwości StandardOutputPath, StandardInputPath ani WorkingDirectory . Jeśli tak, zasób zgłasza nieprawidłowy wyjątek argumentu.

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

Zapewnienia

Określ, czy procesy powinny być uruchomione. Ustaw tę właściwość na , aby Present uruchomić procesy, jeśli nie są uruchomione. Ustaw tę właściwość, aby Absent zatrzymać procesy, jeśli są uruchomione.

Wartość domyślna to Present.

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

StandardErrorPath

Określ pełną ścieżkę do pliku dla procesów, aby zapisywać standardowe strumienie błędów. Ścieżki względne nie są obsługiwane. Jeśli plik istnieje, zostanie zastąpiony.

Nie ustawiaj tej właściwości podczas ustawiania właściwości Upewnij się , że wartość Absent. Jeśli tak, zasób zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String
Default Value: None

StandardInputPath

Określ pełną ścieżkę do pliku dla procesów, które mają być odczytywane jako standardowy strumień wejściowy. Ścieżki względne nie są obsługiwane.

Nie ustawiaj tej właściwości podczas ustawiania właściwości Upewnij się, że Absent wartość lub właściwość Credential na konto systemowe lokalne. Jeśli tak, zasób zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String
Default Value: None

StandardOutputPath

Określ pełną ścieżkę do pliku dla procesów w celu zapisania standardowych strumieni wyjściowych. Ścieżki względne nie są obsługiwane. Jeśli plik istnieje, zostanie zastąpiony.

Nie ustawiaj tej właściwości podczas ustawiania właściwości Upewnij się, że Absent wartość lub właściwość Credential na konto systemowe lokalne. Jeśli tak, zasób zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String
Default Value: None

WorkingDirectory

Określ pełną ścieżkę do folderu dla katalogu roboczego procesów. Ścieżki względne nie są obsługiwane.

Nie ustawiaj tej właściwości podczas ustawiania właściwości Upewnij się, że Absent wartość lub właściwość Credential na konto systemowe lokalne. Jeśli tak, zasób zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String
Default Value: None

Właściwości tylko do odczytu

HandleCount

Liczba dojść otwartych przez procesy.

Type: System.SInt32
Behavior: Read

NonPagedMemorySize

Ilość niestronicowanej pamięci w bajtach przydzielona dla procesów.

Type: System.UInt64
Behavior: Read

PagedMemorySize

Ilość stronicowanej pamięci przydzielonej do procesów w bajtach.

Type: System.UInt64
Behavior: Read

Liczba procesów

Liczba wystąpień danych procesów, które są aktualnie uruchomione.

Type: System.SInt32
Behavior: Read

Identyfikator procesu

Unikatowy identyfikator procesów.

Type: System.SInt32
Behavior: Read

VirtualMemorySize

Ilość pamięci wirtualnej w bajtach przydzielona dla procesów.

Type: System.UInt64
Behavior: Read

Przykłady