Zasób zestawu procesów DSC

Dotyczy: Windows PowerShell 5.x

Zasób ProcessSet w Windows PowerShell Desired State Configuration (DSC) udostępnia mechanizm konfigurowania procesów w węźle docelowym.

Uwaga

Ta dokumentacja tego zasobu DSC obejmuje wersję dołączoną do programu PowerShell w wersji 7.2. Moduł PSDscResources zawiera nowe i zaktualizowane zasoby DSC, które są oficjalnie obsługiwane przez firmę Microsoft. Moduł PSDscResources jest dostępny w Galeria programu PowerShell.

Aby uzyskać więcej informacji i zaktualizować dokumentację, zobacz dokumentację referencyjną usługi PSDscResources.

Składnia

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

Właściwości

Właściwość Opis
Ścieżka Ścieżka do pliku wykonywalnego procesu. Jeśli są to nazwy plików wykonywalnych (nie w pełni kwalifikowane ścieżki), zasób DSC przeszuka zmienną środowiskową $env:Path , aby znaleźć pliki. Jeśli wartości tej właściwości są w pełni kwalifikowanymi ścieżkami, dsC nie będzie używać $env:Path zmiennej środowiskowej do znajdowania plików i zgłasza błąd, jeśli którakolwiek ze ścieżek nie istnieje. Ścieżki względne są niedozwolone.
Poświadczenie Wskazuje poświadczenia do uruchomienia procesu.
StandardErrorPath Ścieżka, do której procesy zapisują standardowy błąd. Każdy istniejący plik zostanie zastąpiony.
StandardInputPath Strumień, z którego proces odbiera standardowe dane wejściowe.
StandardOutputPath Ścieżka pliku, do którego procesy zapisują standardowe dane wyjściowe. Każdy istniejący plik zostanie zastąpiony.
WorkingDirectory Lokalizacja używana jako bieżący katalog roboczy dla procesów.

Wspólne właściwości

Właściwość Opis
Dependson Wskazuje, że konfiguracja innego zasobu musi zostać uruchomiona przed skonfigurowaniem tego zasobu. Jeśli na przykład identyfikator bloku skryptu konfiguracji zasobu, który chcesz uruchomić jako pierwszy, to ResourceName, a jego typ to ResourceType, składnia użycia tej właściwości to DependsOn = "[ResourceType]ResourceName".
Zapewnić Określa, czy procesy istnieją. Ustaw tę właściwość na Wartość Obecna , aby upewnić się, że proces istnieje. W przeciwnym razie ustaw dla niego wartość Nieobecny. Wartość domyślna to Obecny.
PsDscRunAsCredential Ustawia poświadczenie na potrzeby uruchamiania całego zasobu jako.

Uwaga

Właściwość pospolita PsDscRunAsCredential została dodana w programie WMF 5.0, aby umożliwić uruchamianie dowolnego zasobu DSC w kontekście innych poświadczeń. Aby uzyskać więcej informacji, zobacz Use Credentials with DSC Resources (Używanie poświadczeń z zasobami DSC).