Cmdlets de PowerShell para aprovisionamiento del cliente de Windows (referencia)

El cliente de Windows incluye el aprovisionamiento de cmdlets de PowerShell. Estos cmdlets facilitan el script de las siguientes funciones.

Cmdlets

  • Add-ProvisioningPackage: aplica un paquete de aprovisionamiento.

    Sintaxis:

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

  • Remove-ProvisioningPackage: quita un paquete de aprovisionamiento.

    Sintaxis:

    • 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: obtiene información sobre un paquete de aprovisionamiento instalado.

    Sintaxis:

    • 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: extrae el contenido de un paquete de aprovisionamiento.

    Sintaxis:

    • 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: agrega un certificado al almacén de certificados de confianza.

    Sintaxis:

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

  • Get-TrustedProvisioningCertificate: Listas todos los certificados de aprovisionamiento de confianza instalados. Use este cmdlet para obtener la huella digital del certificado que se usará con el Uninstall-TrustedProvisioningCertificate cmdlet .

    Sintaxis:

    • Get-TrustedProvisioningCertificate

  • Uninstall-TrustedProvisioningCertificate: quita un certificado de aprovisionamiento instalado anteriormente.

    Sintaxis:

    • Uninstall-TrustedProvisioningCertificate <thumbprint>

Nota

Puedes usar Get-Help para obtener ayuda sobre el uso de cualquier comando. Por ejemplo: Get-Help Add-ProvisioningPackage

Cuando se usan cmdlets, se capturan registros de seguimiento. Los siguientes registros están disponibles en la carpeta de registros tras la finalización del cmdlet:

  • ProvTrace.<timestamp>.ETL: archivo de seguimiento ETL, no filtrado
  • ProvTrace.<timestamp>.XML: archivo de seguimiento ETL convertido en eventos de seguimiento sin procesar, no filtrado
  • ProvTrace.<timestamp>.TXT: archivo de texto que contiene la salida de seguimiento con un formato que facilita la lectura y que está filtrado para mostrar solo los eventos registrados por los proveedores en el archivo WPRP
  • ProvLogReport.<timestamp>.XLS: archivo de Excel que contiene la salida de seguimiento y que está filtrado para mostrar solo los eventos registrados por los proveedores en el archivo WPRP

Nota

Al aplicar paquetes de aprovisionamiento mediante los cmdlets de PowerShell, el comportamiento predeterminado es suprimir el mensaje que aparece cuando se aplica un paquete de aprovisionamiento sin firmar. Esto es así por diseño, para que los paquetes de aprovisionamiento puedan aplicarse como parte de los scripts existentes.