Compartilhar via


WindowsFeature

Sinopse

Instalar ou desinstalar uma função ou recurso do Windows.

Sintaxe

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

Descrição

O WindowsFeature recurso permite que você verifique se uma função ou recurso do Windows está instalado em um Windows Server. Para gerenciar um computador cliente, use o recurso WindowsOptionalFeature.

Requisitos

  • O computador de destino deve estar executando o Windows Server 2008 ou posterior.
  • O computador de destino deve ter acesso ao módulo DISM PowerShell.
  • O computador de destino deve ter acesso ao módulo ServerManager PowerShell.

Propriedades

Propriedades da chave

Nome

Especifique o nome da função ou recurso como uma cadeia de caracteres.

Esse valor para essa propriedade deve ser o mesmo que a propriedade Name da função ou recurso, não a propriedade DisplayName . Para listar as funções e os recursos disponíveis para um computador, use o Get-WindowsFeature cmdlet.

Type: System.String

Propriedades opcionais

Credencial

Especifique a credencial de uma conta para adicionar ou remover a função ou o recurso como.

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

Ensure

Especifique se a função ou o recurso deve ser instalado. Defina essa propriedade para Present instalar a função ou o recurso se ela não estiver instalada. Defina essa propriedade para Absent desinstalar a função ou o recurso se ela estiver instalada.

O valor padrão é Present.

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

IncludeAllSubFeature

Especifique se todas as subfeaturas do recurso ou função devem ser instaladas. Defina essa propriedade para $true instalar quaisquer subfeaturas ausentes. Defina essa propriedade para $false ignorar subfeaturas. Independentemente da configuração dessa propriedade, o recurso remove todas as subfeaturas se Ensure estiver definido como Absent.

O valor padrão é $false.

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

LogPath

Especifique o caminho para um arquivo para registrar a instalação ou desinstalação do recurso ou função.

Type: System.String
Default Value: None

Propriedades somente leitura

DisplayName

O nome de exibição da função ou recurso recuperado.

Type: System.String

Exemplos