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).