Get-WindowsOptionalFeature

Get-WindowsOptionalFeature

Gets information about optional features in a Windows image.

Sintaxe

Parameter Set: Offline
Get-WindowsOptionalFeature -Path <String> [-FeatureName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-PackageName <String> ] [-PackagePath <String> ] [-ScratchDirectory <String> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]

Parameter Set: Online
Get-WindowsOptionalFeature -Online [-FeatureName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-PackageName <String> ] [-PackagePath <String> ] [-ScratchDirectory <String> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]

Descrição detalhada

The Get-WindowsOptionalFeature cmdlet gets information about all features (operating system features that include optional Windows foundation features) in the Windows Foundation Package or a specified package in the Windows image.

Use the PackageName or PackagePath parameter to get information about all features in a specific package in the Windows image.

The FeatureName parameter gets more detailed information about a specific feature in the Windows image. If the feature is not a part of the Windows Foundation package, either a PackageName or PackagePath parameter must be used to specify the parent package of the feature.

Use o parâmetro Online para especificar o sistema operacional em execução em seu computador local ou use o parâmetro Path para especificar o local de uma imagem montada do Windows.

Parâmetros

-FeatureName<String>

Specifies the name of a feature to get detailed information about. Feature names are case sensitive if you are servicing a Windows image other than Windows 8.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

true

-LogLevel<LogLevel>

Especifica o nível máximo de saída exibido nos logs. O nível de log padrão é 3. Os valores aceitos são os seguintes:1 = somente erros2 = erros e avisos3 = erros, avisos e informações4 = todas as informações listadas anteriormente, além de saída de depuração

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-LogPath<String>

Especifica o caminho completo e o nome de arquivo para fazer logon. Se não estiver configurado, o padrão é %WINDIR%\Logs\Dism\dism.log.No Windows PE, o diretório padrão é o espaço temporário RAMDISK, que pode ter apenas 32 MB. O arquivo de log será arquivado automaticamente. O arquivo de log será salvo com a extensão .bak acrescentada ao nome do arquivo e um novo arquivo de log será gerado. Sempre que o arquivo de log for arquivado, o arquivo .bak será substituído. Ao usar um compartilhamento de rede que não tenha ingressado em um domínio, use o comando net use junto com as credenciais de domínio para configurar as permissões de acesso antes de configurar o caminho do log do DISM.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-Online

Especifica que uma ação deve ser realizada no sistema operacional que está sendo executado no computador local.

Aliases

nenhuma

Necessário?

true

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-PackageName<String>

Specifies the name of a package as it is listed in the Windows image. Use the PackageName parameter to get all of the features in the package. Use the FeatureName and PackageName parameters to get more detailed information about a specific feature in the package.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

true

-PackagePath<String>

Specifies the location of a .cab file in the Windows image. Use the PackagePath parameter to get all of the features in the package. Use the FeatureName and PackagePath parameters to get more detailed information about a specific feature in the package.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-Path<String>

Especifica o caminho completo para o diretório raiz da imagem offline do Windows cuja manutenção será feita. Se o diretório chamado Windows não for um subdiretório do diretório raiz, - WindowsDirectory deverá ser especificado.

Aliases

nenhuma

Necessário?

true

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-ScratchDirectory<String>

Especifica um diretório temporário que será usado ao extrair arquivos para uso durante a manutenção. O diretório deve existir localmente. Se ele não for especificado, o diretório \Windows\%Temp% será usado com um nome de subdiretório de valor hexadecimal gerado aleatoriamente para cada execução do DISM. Os itens do diretório temporário serão excluídos depois de cada operação. Você não deve usar um local de compartilhamento de rede como um diretório temporário para expandir um pacote (arquivo .cab ou .msu) para instalação. O diretório usado para extrair arquivos para uso temporário durante a manutenção deve ser um diretório local.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-SystemDrive<String>

Especifica o caminho para o local dos arquivos BootMgr. Isso somente é necessário quando os arquivos BootMgr estiverem localizados em uma partição diferente daquela na qual você está executando o comando. Use -SystemDrive para fazer a manutenção de uma imagem do Windows instalada de um ambiente Windows PE.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-WindowsDirectory<String>

Especifica o caminho para o diretório Windows relativo ao caminho da imagem. Não pode ser o caminho completo para o diretório Windows; deve ser um caminho relativo. Se ele não for especificado, o padrão será o diretório do Windows na raiz do diretório de imagens offline.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet dá suporte a parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet.

  • System.String[]
  • Microsoft.Dism.Commands.ImageObject

Saídas

O tipo de saída é o tipo de objeto emitido pelo cmdlet.

  • Microsoft.Dism.Commands.BasicFeatureObject
  • Microsoft.Dism.Commands.AdvancedFeatureObject

Exemplos

Example 1

This command lists all of the optional features in the running Windows operating system.

PS C:\> Get-WindowsOptionalFeature –Online

Example 2

This command displays lists all of the optional features in the specified package in the Windows image mounted to c:\offline.

PS C:\> Get-WindowsOptionalFeature –Path c:\offline –PackageName Microsoft-Windows-Backup-Package~31bf3856ad364e35~x86~~6.1.7601.16525

Example 3

This command displays detailed information about the feature, Hearts, in the Windows Foundation Package in the Windows image mounted to c:\offline.

PS C:\> Get-WindowsOptionalFeature –Path c:\offline –FeatureName Hearts

Example 4

This command displays detailed information about the feature, MyFeature, in the package at c:\package\package.cab in the Windows image mounted to c:\offline.

PS C:\> Get-WindowsOptionalFeature –Path c:\offline –FeatureName MyFeature –PackagePath c:\packages\package.cab

Tópicos relacionados

Add-WindowsPackage

Enable-WindowsOptionalFeature

Get-WindowsPackage