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
}
}
}
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla