Командлеты PowerShell для подготовки клиента Windows (справочник)

  • Статья
  • Применяется к:
    ✅ Windows 11, ✅ Windows 10

Клиент Windows включает командлеты PowerShell для подготовки. Эти командлеты облегчают создание сценариев для следующих функций.

Командлеты

  • 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: Списки все установленные доверенные сертификаты подготовки. Используйте этот командлет, чтобы получить отпечаток сертификата для использования с командлетом Uninstall-TrustedProvisioningCertificate .

    Синтаксис:

    • Get-TrustedProvisioningCertificate

  • Uninstall-TrustedProvisioningCertificate: удаляет ранее установленный сертификат подготовки.

    Синтаксис:

    • Uninstall-TrustedProvisioningCertificate <thumbprint>

Примечание.

Чтобы получить сведения об использовании любой команды можно использовать Get-Help. Например: Get-Help Add-ProvisioningPackage

Журналы трассировки регистрируются при помощи командлетов. Следующие журналы доступны в папке журналов после завершения командлета:

  • ProvTrace.<timestamp>.ETL — файл трассировки (ETL), без фильтра
  • ProvTrace.<timestamp>.XML — файл трассировки (ETL), преобразованный в необработанные события трассировки, без фильтра
  • ProvTrace.<timestamp>.TXT — текстовый файл, содержащий выходные данные, отформатированные для удобного чтения, отфильтрованные таким образом, чтобы отображать только события, зарегистрированные поставщиками в файле WPRP
  • ProvLogReport.<timestamp>.XLS — файл Excel, содержащий выходные данные трассировки, отфильтрованные таким образом, чтобы отображать только события, зарегистрированные в файле WPRP

Примечание.

При применении пакетов подготовки с помощью командлетов Powershell, поведением по умолчанию является подавление запроса, который появляется при применении неподписанного пакета подготовки. Это сделано намеренно, чтобы пакеты подготовки можно было применять как часть имеющихся сценариев.