WindowsFeature

  • Artykuł

Streszczenie

Instalowanie lub odinstalowywanie roli lub funkcji systemu Windows.

Składnia

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

Opis

Zasób WindowsFeature umożliwia upewnienie się, czy rola lub funkcja systemu Windows jest zainstalowana w systemie Windows Server. Aby zarządzać komputerem klienckim, użyj zasobu WindowsOptionalFeature.

Wymagania

  • Maszyna docelowa musi być uruchomiona w systemie Windows Server 2008 lub nowszym.
  • Maszyna docelowa musi mieć dostęp do modułu DISM programu PowerShell.
  • Maszyna docelowa musi mieć dostęp do modułu ServerManager programu PowerShell.

Właściwości

Kluczowe właściwości

Nazwa

Określ nazwę roli lub funkcji jako ciąg.

Ta wartość dla tej właściwości powinna być taka sama jak właściwość Name roli lub funkcji, a nie właściwość DisplayName . Aby wyświetlić listę dostępnych ról i funkcji dla komputera, użyj Get-WindowsFeature polecenia cmdlet .

Type: System.String

Właściwości opcjonalne

Poświadczenie

Określ poświadczenia dla konta, aby dodać lub usunąć rolę lub funkcję jako.

Type: System.Management.Automation.PSCredential
Default Value: None

Zapewnienia

Określ, czy rola lub funkcja ma być zainstalowana. Ustaw tę właściwość na , aby Present zainstalować rolę lub funkcję, jeśli nie jest zainstalowana. Ustaw tę właściwość na wartość , aby Absent odinstalować rolę lub funkcję, jeśli została zainstalowana.

Wartość domyślna to Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

IncludeAllSubFeature

Określ, czy należy zainstalować każdą podfeektę funkcji lub roli. Ustaw tę właściwość na , aby $true zainstalować wszystkie brakujące podfunkcje. Ustaw tę właściwość na $false , aby ignorować podfunkcje. Niezależnie od ustawienia tej właściwości zasób usuwa wszystkie podfunkcje, jeśli opcja Upewnij się , że jest ustawiona wartość Absent.

Wartość domyślna to $false.

Type: System.Boolean
Behavior: Write
Default Value: false

Ścieżka dziennika

Określ ścieżkę do pliku, aby zarejestrować instalację lub odinstalowanie funkcji lub roli.

Type: System.String
Default Value: None

Właściwości tylko do odczytu

Nazwa wyświetlana

Nazwa wyświetlana pobranej roli lub funkcji.

Type: System.String

Przykłady