Zasób DSC WindowsFeatureSet

Dotyczy: Windows PowerShell 5.x

Zasób WindowsFeatureSet w Windows PowerShell Desired State Configuration (DSC) zapewnia mechanizm zapewniający, że role i funkcje są dodawane lub usuwane w węźle docelowym. Ten zasób jest zasobem złożonym , który wywołuje zasób WindowsFeature dla każdej funkcji określonej we właściwości Name .

Użyj tego zasobu, jeśli chcesz skonfigurować wiele funkcji systemu Windows do tego samego stanu.

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

WindowsFeatureSet [string] #ResourceName
{
    Name = [string[]]
    [ Source = [string] ]
    [ IncludeAllSubFeature = [Boolean] ]
    [ Credential = [PSCredential] ]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Właściwości

Właściwość	Opis
Nazwa	Nazwy ról lub funkcji, które mają zostać dodane lub usunięte. Jest to taka sama jak właściwość Name polecenia cmdlet Get-WindowsFeature , a nie nazwa wyświetlana ról lub funkcji.
Element źródłowy	Wskazuje lokalizację pliku źródłowego do użycia do instalacji w razie potrzeby.
IncludeAllSubFeature	Ustaw tę właściwość, aby uwzględnić $true wszystkie wymagane podfeature z funkcjami określonymi za pomocą właściwości Name .
Poświadczenie	Poświadczenia używane do dodawania lub usuwania ról lub funkcji.
Ścieżka dziennika	Ścieżka 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 są dodawane role czy funkcje. Aby upewnić się, że zostały dodane role lub funkcje, ustaw tę właściwość na Wartość Prezent. Aby upewnić się, że role lub funkcje są usuwane, 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

Poniższa konfiguracja gwarantuje, że funkcje serwera sieci Web (IIS) i serwera SMTP oraz wszystkie podfeatury każdego z nich są zainstalowane.

configuration FeatureSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

        WindowsFeatureSet WindowsFeatureSetExample
        {
            Name                    = @("SMTP-Server", "Web-Server")
            Ensure                  = 'Present'
            IncludeAllSubFeature    = $true
        }
    }
}