New-CMPrestageMedia

Ссылка

Модуль:: ConfigurationManager

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

Синтаксис

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). Для выполнения этого командлета требуются повышенные разрешения.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowUnattended

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowUnknownMachine

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Application

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

Type:	IResultObject[]
Aliases:	Applications
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BootImage

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

Type:	IResultObject
Aliases:	BootImagePackage
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateExpireTime

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

Например:

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePassword

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

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePath

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateStartTime

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

Например:

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreatedBy

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPoint

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

Type:	IResultObject[]
Aliases:	DistributionPoints
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DriverPackage

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

Type:	IResultObject[]
Aliases:	DriverPackages, PackageDriver, PackageDrivers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeApplicationDependency

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

Type:	SwitchParameter
Aliases:	IncludeApplicationDependencies
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagementPoint

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

Type:	IResultObject[]
Aliases:	ManagementPoints
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaMode

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

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

Type:	MediaMode
Accepted values:	Dynamic, SiteBased
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaPassword

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

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoAutoRun

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystemImage

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

Type:	IResultObject
Aliases:	OperatingSystemImagePackage
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystemImageIndex

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Package

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

Type:	IResultObject[]
Aliases:	Packages
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

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

C:\media\prestaged1.wim
\\server\share\prestaged1.wim

Type:	String
Aliases:	MediaPath, OutputPath, DriveName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PrestartCommand

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

Type:	String
Aliases:	PreExecCommandLine
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrestartPackage

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SiteCode

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TaskSequence

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TemporaryFolder

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

Type:	String
Aliases:	TemporaryDirectory, StagingArea
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserDeviceAffinity

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

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

Type:	UserDeviceAffinityType
Accepted values:	DoNotAllow, AdministratorApproval, AutoApproval
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Variable

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

Type:	Hashtable
Aliases:	TaskSequenceVariables, Variables
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Version

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

None

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

System.Object

Примечания

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