Поделиться через


New-CMPrestageMedia

Создайте предварительно подготовленный файл мультимедиа развертывания ОС.

Синтаксис

New-CMPrestageMedia
   [-Application <IResultObject[]>]
   [-Comment <String>]
   [-CreatedBy <String>]
   [-DriverPackage <IResultObject[]>]
   [-IncludeApplicationDependency]
   -OperatingSystemImage <IResultObject>
   [-OperatingSystemImageIndex <Int32>]
   [-Package <IResultObject[]>]
   -TaskSequence <IResultObject>
   [-Version <String>]
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-CMPrestageMedia создает файл для предварительной подготовки образа ОС на новом жестком диске. Дополнительные сведения см. в разделе Планирование предварительно подготовленного носителя.

Примечание.

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

Примеры

Пример 1. Создание предварительно подготовленного носителя

Первая команда получает объект точки управления для сервера системы сайта с именем mp01.contoso.com в коде сайта CM1 и сохраняет объект в переменной $ManagementPoint .

Вторая команда получает объект образа загрузки с именем BootImage01 и сохраняет его в переменной $BootImage .

Третья команда получает объект точки распространения для сервера системы сайта с именем dist01.contoso.com в коде сайта CM1 и сохраняет объект в переменной $DistributionPoint .

Четвертая команда получает объект образа ОС с именем OSImagePkg01 и сохраняет объект в переменной $OSImage .

Последняя команда создает динамический предварительно подготовленный файл мультимедиа с именем PrestagedMedia.wim с загрузочным образом, хранящимся в $BootImage, точкой распространения, хранящейся в $DistributionPoint, точкой управления, хранящейся в $ManagementPoint, и образом ОС, хранящимся в $OSImage.

$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"

New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImage

Параметры

-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

-Application

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

Тип:IResultObject[]
Aliases:Applications
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

-Comment

Необязательная строка для предоставления дополнительных сведений о носителе. Полезно описать, как вы настроили или как будете использовать этот носитель. Максимальная длина — 127 символов.

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

-Confirm

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

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

-CreatedBy

Необязательная строка, указывающая, кто создал этот носитель, что полезно для отслеживания. Максимальная длина — 50 символов.

Тип:String
Position:Named
Default value:None
Обязательно: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

-DriverPackage

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

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

-Force

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

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

-ForceWildcardHandling

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

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

-IncludeApplicationDependency

Добавьте этот параметр для обнаружения связанных зависимостей приложений и добавления их на этот носитель.

Тип:SwitchParameter
Aliases:IncludeApplicationDependencies
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

-NoAutoRun

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

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

-OperatingSystemImage

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

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

-OperatingSystemImageIndex

Укажите индекс образа в пакете образа из параметра OperatingSystemImage .

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

-Package

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

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

-Path

Путь к создаваемому файлу мультимедиа. Формат — это путь к диску или каталогу или допустимый сетевой путь. Например:

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

-PrestartCommand

Укажите командную строку, выполняемую перед запуском последовательности задач. Дополнительные сведения см. в разделе Команды перед запуском для носителя последовательности задач.

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

-PrestartPackage

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

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

-SiteCode

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

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

-TaskSequence

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

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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

-Version

Необязательное строковое значение, указывающее версию для этого носителя, которое полезно для отслеживания и редакции. Максимальная длина — 32 символа.

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

-WhatIf

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

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

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

None

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

System.Object

Примечания

Псевдонимы командлетов: New-CMPrestagedMedia