Udostępnij za pośrednictwem

Zasób DSC WindowsFeature

  • Artykuł

Dotyczy: Windows PowerShell 4.0, Windows PowerShell 5.x

Zasób WindowsFeature w Windows PowerShell Desired State Configuration (DSC) zapewnia mechanizm zapewniający, że role i funkcje są dodawane lub usuwane 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

WindowsFeature [string] #ResourceName
{
    Name = [string]
    [ Credential = [PSCredential] ]
    [ IncludeAllSubFeature = [bool] ]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Właściwości

Właściwość Opis
Nazwa Wskazuje nazwę roli lub funkcji, którą chcesz upewnić się, że została dodana lub usunięta. Jest to taka sama jak właściwość Name z polecenia cmdlet Get-WindowsFeature , a nie nazwa wyświetlana roli lub funkcji.
Poświadczenie Wskazuje poświadczenia używane do dodawania lub usuwania roli lub funkcji.
IncludeAllSubFeature Ustaw tę właściwość, aby $true zapewnić stan wszystkich wymaganych podfeatur ze stanem funkcji określonej za pomocą właściwości Name .
Ścieżka dziennika Wskazuje ścieżkę do pliku dziennika, w którym dostawca zasobów ma rejestrować operację.

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ć Wskazuje, czy rola lub funkcja jest dodawana. Aby upewnić się, że rola lub funkcja została dodana, ustaw tę właściwość na Wartość Prezent. Aby upewnić się, że rola lub funkcja została usunięta, ustaw właściwość na 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).

Przykład

WindowsFeature RoleExample
{
    Ensure = "Present"
    # Alternatively, to ensure the role is uninstalled, set Ensure to "Absent"
    Name = "Web-Server" # Use the Name property from Get-WindowsFeature
}