Cmdlets do PowerShell para provisionamento do cliente Windows (referência)

O cliente Windows inclui o provisionamento de cmdlets do PowerShell. Esses cmdlets facilitam às seguintes funções de script.

Cmdlets

  • Add-ProvisioningPackage: aplica um pacote de provisionamento.

    Sintaxe:

    • Add-ProvisioningPackage [-Path] <string> [-ForceInstall] [-LogsFolder <string>] [-QuietInstall] [-WprpFile <string>] [<CommonParameters>]

  • Remove-ProvisioningPackage: remove um pacote de provisionamento.

    Sintaxe:

    • Remove-ProvisioningPackage -PackageId <string> [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]
    • Remove-ProvisioningPackage -Path <string> [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]
    • Remove-ProvisioningPackage -AllInstalledPackages [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]

  • Get-ProvisioningPackage: obtém informações sobre um pacote de provisionamento instalado.

    Sintaxe:

    • Get-ProvisioningPackage -PackageId <string> [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]
    • Get-ProvisioningPackage -Path <string> [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]
    • Get-ProvisioningPackage -AllInstalledPackages [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]

  • Export-ProvisioningPackage: extrai o conteúdo de um pacote de provisionamento.

    Sintaxe:

    • Export-ProvisioningPackage -PackageId <string> -OutputFolder <string> [-Overwrite] [-AnswerFileOnly] [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]
    • Export-ProvisioningPackage -Path <string> -OutputFolder <string> [-Overwrite] [-AnswerFileOnly] [-LogsFolder <string>] [-WprpFile <string>] [<CommonParameters>]

  • Install-TrustedProvisioningCertificate: adiciona um certificado ao repositório certificado confiável.

    Sintaxe:

    • Install-TrustedProvisioningCertificate <path to local certificate file on disk>

  • Get-TrustedProvisioningCertificate: Listas todos os certificados de provisionamento confiáveis instalados. Use este cmdlet para obter a impressão digital do certificado a ser usada com o Uninstall-TrustedProvisioningCertificate cmdlet.

    Sintaxe:

    • Get-TrustedProvisioningCertificate

  • Uninstall-TrustedProvisioningCertificate: remove um certificado de provisionamento instalado anteriormente.

    Sintaxe:

    • Uninstall-TrustedProvisioningCertificate <thumbprint>

Observação

Você pode usar Get-Help para obter ajuda de uso em qualquer comando. Por exemplo: Get-Help Add-ProvisioningPackage

Logs de rastreamento são capturados ao usar os cmdlets. Os logs a seguir estão disponíveis na pasta de logs após a conclusão do cmdlet:

  • ProvTrace.<timestamp>.ETL - Arquivo de rastreamento ETL, sem filtro
  • ProvTrace.<timestamp>.XML - Arquivo de rastreamento ETL convertido em eventos de rastreamento bruto, sem filtro
  • ProvTrace.<timestamp>.TXT - Arquivo de texto que contém a saída de rastreamento formatada para facilitar a leitura, filtrada para mostrar somente eventos registrados pelos provedores no arquivo WPRP
  • ProvLogReport.<timestamp>.XLS - Arquivo Excel contendo a saída de rastreamento, filtrada para mostrar somente eventos registrados pelos provedores no arquivo WPRP

Observação

Ao aplicar pacotes de provisionamento usando os cmdlets do Powershell, o comportamento padrão suprime o prompt que aparece ao aplicar um pacote do provisionamento não assinado. Isso ocorre por design, para que os pacotes de provisionamento possam ser aplicados como parte de scripts existentes.