WindowsFeature

Synopse

Nainstalujte nebo odinstalujte roli nebo funkci systému Windows.

Syntax

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

Description

Prostředek WindowsFeature umožňuje zajistit, jestli je na Windows Serveru nainstalovaná role nebo funkce Systému Windows. Ke správě klientského počítače použijte prostředek WindowsOptionalFeature.

Požadavky

  • Cílový počítač musí mít systém Windows Server 2008 nebo novější.
  • Cílový počítač musí mít přístup k modulu POWERShellu DISM .
  • Cílový počítač musí mít přístup k modulu PowerShellu Správce serveru .

Vlastnosti

Základní vlastnosti

Name

Zadejte název role nebo funkce jako řetězec.

Tato hodnota této vlastnosti by měla být stejná jako vlastnost Name role nebo funkce, nikoli Vlastnost DisplayName . Pokud chcete zobrazit seznam dostupných rolí a funkcí pro počítač, použijte rutinu Get-WindowsFeature .

Type: System.String

Volitelné vlastnosti

Přihlašovací údaj

Zadejte přihlašovací údaje pro účet, který má přidat nebo odebrat roli nebo funkci jako.

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

Zajištění

Určete, jestli má být role nebo funkce nainstalována. Tuto vlastnost nastavte tak, aby Present se role nebo funkce nainstalovala, pokud není nainstalovaná. Tuto vlastnost nastavte na Absent odinstalaci role nebo funkce, pokud je nainstalovaná.

Výchozí hodnota je Present.

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

IncludeAllSubFeature

Určete, zda se má nainstalovat každá dílčí součást funkce nebo role. Nastavte tuto vlastnost tak, aby $true se nainstalovaly všechny chybějící dílčí funkce. Nastavte tuto vlastnost tak, aby $false ignorovala dílčí funkce. Regardless of this property's setting, the resource removes all subfeatures if Ensure is set to Absent.

Výchozí hodnota je $false.

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

LogPath

Zadejte cestu k souboru pro protokolování instalace nebo odinstalace funkce nebo role.

Type: System.String
Default Value: None

Vlastnosti jen pro čtení

DisplayName

Zobrazovaný název načtené role nebo funkce

Type: System.String

Příklady