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