New-CMBootableMedia

Создание загрузочного носителя.

Синтаксис

New-CMBootableMedia
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-FormatMedia]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   -MediaType <MediaInputType>
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Этот командлет создает носитель, используемый для развертывания ОС. Загрузочный носитель содержит образ загрузки, необязательные команды перед запуском и связанные файлы, а также файлы Configuration Manager. Используйте загрузочный носитель для установки новой версии Windows на новом компьютере (без операционной системы) или для замены существующего компьютера и передачи параметров.

Примечание.

Для выполнения этого командлета требуются повышенные разрешения.

Дополнительные сведения см. в статье Общие сведения о носителе последовательности задач.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Создание загрузочного носителя

Первая команда получает объект образа загрузки с именем Boot image (x64) и сохраняет его в переменной $BootImage . Вторая команда получает роль точки распространения для SiteServer01.Contoso.com и сохраняет ее в переменной $DistributionPoint . Третья команда получает роль точки управления для SiteServer02.Contoso.com и сохраняет ее в переменной $ManagementPoint . Последняя команда создает загрузочный носитель в динамическом режиме. В нем используются объекты, хранящиеся в предыдущих переменных.

$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"

New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint

Параметры

-AllowUacPrompt

Добавьте этот параметр, чтобы разрешить Windows запрашивать повышение разрешений администратора с помощью контроля учетных записей (UAC). Для выполнения этого командлета требуются повышенные разрешения.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowUnattended

Добавьте этот параметр, чтобы разрешить автоматическое развертывание ОС. Автоматическое развертывание ОС не запрашивает конфигурацию сети или необязательные последовательности задач.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowUnknownMachine

Добавьте этот параметр, чтобы разрешить Configuration Manager подготавливать неизвестные компьютеры. Неизвестный компьютер — это компьютер, который сайт еще не обнаружил.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BootImage

Укажите объект образа загрузки. Чтобы получить этот объект, используйте командлет Get-CMBootImage .

Тип:IResultObject
Aliases:BootImagePackage
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CertificateExpireTime

При создании самозаверяющего сертификата мультимедиа для обмена данными по протоколу HTTP этот параметр указывает дату и время окончания срока действия сертификата. Достаточно укажите дату и время в будущем. По истечении срока действия этого сертификата вы не сможете использовать загрузочный носитель. Используйте параметр -CertificateStartTime , чтобы задать дату начала.

Например:

$date = [datetime]::p arseexact("16.11.2021", 'MM/dd/yyyy', $null)

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CertificatePassword

Если для импорта PKI-сертификата для обмена данными по протоколу HTTPS используется параметр -CertificatePath , используйте этот параметр, чтобы указать пароль для файла сертификата.

Тип:SecureString
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CertificatePath

Укажите путь к PKI-сертификату для импорта. Используйте параметр -CertificatePassword , чтобы указать пароль для этого файла сертификата. Используйте эти параметры, если на сайте настроен обмен данными с клиентом HTTPS.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CertificateStartTime

Чтобы создать самозаверяющий сертификат для обмена данными по протоколу HTTP, этот параметр указывает дату и время начала сертификата. Используйте параметр -CertificateExpireTime , чтобы задать дату окончания срока действия. Вы не сможете использовать загрузочный носитель до этой даты.

Например:

$date = [datetime]::p arseexact("16.11.2020", 'MM/dd/yyyy', $null)

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DistributionPoint

Укажите один или несколько объектов точки распространения, для которых был распределен образ загрузки. Чтобы получить этот объект, используйте командлет Get-CMDistributionPoint .

Тип:IResultObject[]
Aliases:DistributionPoints
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Выполните команду, не запрашивая подтверждение.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FormatMedia

Если mediaType имеет значение Usb, этот параметр можно добавить, чтобы отформатировать съемный USB-накопитель как FAT32 и сделать его загрузочным.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ManagementPoint

Укажите один или несколько объектов точки управления, которые носитель использует при первоначальном взаимодействии. Используйте параметр -MediaMode , чтобы определить, как мультимедиа обменивается данными при запуске. Чтобы получить этот объект, используйте командлет Get-CMManagementPoint .

Тип:IResultObject[]
Aliases:ManagementPoints
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MediaMode

Укажите, как клиент находит точку управления для получения сведений о развертывании:

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

  • SiteBased: носитель сообщает точку управления, указанную с помощью параметра -ManagementPoint .

Тип:MediaMode
Допустимые значения:Dynamic, SiteBased
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MediaPassword

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

Тип:SecureString
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MediaType

Укажите, является ли носитель набором компакт-дисков или DVD-дисков или съемным USB-накопителем.

Тип:MediaInputType
Допустимые значения:Usb, CdDvd
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NoAutoRun

Добавьте этот параметр, чтобы включить файл autorun.inf на носитель. Configuration Manager не добавляет его по умолчанию. Этот файл обычно блокируется антивредоносными продуктами. Дополнительные сведения о функции автозапуска Windows см. в статье Создание приложения с поддержкой автозапуска компакт-дисков. Если это все равно необходимо для вашего сценария, добавьте этот параметр, чтобы включить файл.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Если mediaType имеет значение CdDvd, укажите имя и путь, по которому Configuration Manager записывает выходные файлы. Например, C:\output\boot.iso.

Тип:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PrestartCommand

Укажите команду перед запуском, которая выполняется перед последовательностью задач. Команда перед запуском — это скрипт или исполняемый файл, который может взаимодействовать с пользователем в Среде предустановки Windows перед выполнением последовательности задач для установки ОС. Если команда не является собственной для Windows PE, используйте PrestartPackage , чтобы включить файлы для команды .

Тип:String
Aliases:PreExecCommandLine
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PrestartPackage

Если используется параметр PrestartCommand , используйте этот параметр, чтобы указать пакет, содержащий файлы для команды prestart. Чтобы получить объект пакета, используйте командлет Get-CMPackage .

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SiteCode

Применяется к версии 2010 и более поздним. Используйте этот параметр вместе с параметром ManagementPoint , чтобы указать код сайта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TemporaryFolder

Процесс создания носителя может потребовать много временного места на диске. По умолчанию Configuration Manager использует временный каталог текущего пользователя: $env:temp. Например, C:\Users\jqpublic\AppData\Local\Temp\. Чтобы обеспечить большую гибкость хранения этих временных файлов, укажите пользовательское расположение для промежуточного хранения временных данных.

Тип:String
Aliases:TemporaryDirectory, StagingArea
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserDeviceAffinity

Чтобы обеспечить поддержку управления, ориентированного на пользователей, в Configuration Manager укажите, как носитель будет связывать пользователей с конечным компьютером. Дополнительные сведения о том, как развертывание ОС поддерживает сходство пользователей с устройствами, см. в статье Связывание пользователей с конечным компьютером.

  • DoNotAllow: не разрешайте сопоставление пользователей и устройств. Носитель не связывает пользователей с конечным компьютером. В этом сценарии последовательность задач не связывает пользователей с конечным компьютером при развертывании ОС.

  • AdministratorApproval: разрешить сопоставление пользователей и устройств в ожидании утверждения администратора. После предоставления утверждения носитель связывает пользователей с конечным компьютером. Эта функция основана на области последовательности задач, которая развертывает ОС. В этом сценарии последовательность задач создает связь между указанными пользователями и конечным компьютером. Затем он ожидает утверждения от администратора перед развертыванием ОС.

  • AutoApproval: разрешить сопоставление пользователей и устройств с автоматическим утверждением. Носитель автоматически связывает пользователей с конечным компьютером. Эта функция основана на действиях последовательности задач, которая развертывает ОС. В этом сценарии последовательность задач создает связь между указанными пользователями и конечным компьютером при развертывании ОС на целевом компьютере.

Тип:UserDeviceAffinityType
Допустимые значения:DoNotAllow, AdministratorApproval, AutoApproval
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Variable

Укажите одну или несколько переменных и значений последовательности задач в хэш-таблицы. Переменная последовательности задач — это пара "имя-значение", которая используется во время развертывания последовательности задач.

Тип:Hashtable
Aliases:TaskSequenceVariables, Variables
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

System.Object