用于预配 Windows 客户端的 PowerShell cmdlet（参考）

Windows 客户端包括预配 PowerShell cmdlet。 这些 cmdlet 让你可以轻松地对以下函数进行脚本处理。

Cmdlet

  • Add-ProvisioningPackage：应用预配包。

    语法：

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

  • Remove-ProvisioningPackage：删除预配包。

    语法：

    • 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：获取有关已安装的预配包的信息。

    语法：

    • 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：提取预配包的内容。

    语法：

    • 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：将证书添加到受信任的证书存储区。

    语法：

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

  • Get-TrustedProvisioningCertificate：Lists所有已安装的受信任预配证书。 使用此 cmdlet 获取用于 cmdlet 的 Uninstall-TrustedProvisioningCertificate 证书指纹。

    语法：

    • Get-TrustedProvisioningCertificate

  • Uninstall-TrustedProvisioningCertificate：删除以前安装的预配证书。

    语法：

    • Uninstall-TrustedProvisioningCertificate <thumbprint>

注意

你可以使用 Get-Help 获取有关任何命令的使用帮助。 例如：Get-Help Add-ProvisioningPackage

在使用 cmdlet 时捕获跟踪日志。 当 cmdlet 完成后，将在日志文件夹中提供以下日志：

  • ProvTrace.<timestamp>.ETL - ETL 跟踪文件，未筛选
  • ProvTrace.<timestamp>.XML - 转换为原始跟踪事件的 ETL 跟踪文件，未筛选
  • ProvTrace.<timestamp>.TXT - 包含为便于读取而设置格式的跟踪输出的 TEXT 文件，经筛选仅在 WPRP 文件中显示提供程序记录的事件
  • ProvLogReport.<timestamp>.XLS - 包含跟踪输出的 Excel 文件，经筛选仅在 WPRP 文件中显示提供程序记录的事件

注意

使用 Powershell cmdlet 应用预配包时，默认行为是隐藏在应用未签名的预配包时显示的提示。 这是设计使然，因此，可以应用预配包作为现有脚本的一部分。