用於佈建 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：清單 所有已安裝的受信任布建憑證。 使用此 Cmdlet 取得與 Uninstall-TrustedProvisioningCertificate Cmdlet 搭配使用的憑證指紋。

    語法：

    • 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 套件佈建套件時，預設行為是抑制在套用未簽署的佈建套件時會顯示的提示。 這是原本設計的做法，讓佈建套件能夠套用以作為現有指令碼的一部分。