PowerShell Cmdlets für die Bereitstellung von Windows Client (Referenz)

Der Windows-Client enthält PowerShell-Cmdlets für die Bereitstellung. Diese Cmdlets erleichtern Ihnen das Skripten der folgenden Funktionen.

Cmdlets

  • Add-ProvisioningPackage: Wendet ein Bereitstellungspaket an.

    Syntax:

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

  • Remove-ProvisioningPackage: Entfernt ein Bereitstellungspaket.

    Syntax:

    • 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: Ruft Informationen zu einem installierten Bereitstellungspaket ab.

    Syntax:

    • 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: Extrahiert den Inhalt eines Bereitstellungspakets.

    Syntax:

    • 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: Fügt dem Speicher für vertrauenswürdige Zertifikate ein Zertifikat hinzu.

    Syntax:

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

  • Get-TrustedProvisioningCertificate: Listen alle installierten vertrauenswürdigen Bereitstellungszertifikate. Verwenden Sie dieses Cmdlet, um den Zertifikatfingerabdruck abzurufen, der mit dem Uninstall-TrustedProvisioningCertificate Cmdlet verwendet werden soll.

    Syntax:

    • Get-TrustedProvisioningCertificate

  • Uninstall-TrustedProvisioningCertificate: Entfernt ein zuvor installiertes Bereitstellungszertifikat.

    Syntax:

    • Uninstall-TrustedProvisioningCertificate <thumbprint>

Hinweis

Mit Get-Help erhalten Sie entsprechende Hilfe zu einem beliebigen Befehl. Beispiel: Get-Help Add-ProvisioningPackage

Ablaufverfolgungsprotokolle werden erfasst, wenn Sie Cmdlets verwenden. Die folgenden Protokolle sind im Protokollordner nach Abschluss des Cmdlets verfügbar:

  • ProvTrace.<timestamp>.ETL: ETL-Ablaufverfolgungsdatei, ungefiltert
  • ProvTrace.<timestamp>.XML: ETL-Ablaufverfolgungsdatei konvertiert in unformatierte Ablaufverfolgungsereignisse, ungefiltert
  • ProvTrace.<timestamp>.TXT: TEXT-Datei mit formatierter Ablaufverfolgungsausgabe für einfaches Lesen, gefiltert, um nur von Anbietern in der WPRP-Datei protokollierte Ereignisse anzuzeigen
  • ProvLogReport.<timestamp>.XLS: Excel-Datei mit Ablaufverfolgungsausgabe, gefiltert, um nur von Anbietern in der WPRP-Datei protokollierte Ereignisse anzuzeigen

Hinweis

Wenn Sie mithilfe von Powershell-Cmdlets Bereitstellungspakete anwenden, ist das Standardverhalten, die Eingabeaufforderung zu unterdrücken, die angezeigt wird, wenn ein nicht signiertes Bereitstellungspaket angewendet wird. Dies ist beabsichtigt, sodass Bereitstellungspakete als Teil der vorhandenen Skripts angewendet werden können.