Set-CMBootImage

Ссылка

Модуль:: ConfigurationManager

Изменение образа загрузки ОС.

Синтаксис

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   -Id <String>
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет для изменения образа загрузки ОС. Загрузочные образы — это образы среды предустановки Windows (Windows PE), в которые загружается клиентский компьютер перед установкой ОС.

Вы можете добавить драйверы устройств в загрузочный образ или изменить его свойства. Перед добавлением нового драйвера устройства необходимо сначала импортировать драйвер в каталог драйверов Configuration Manager и включить его.

Каждая версия Configuration Manager поддерживает определенную версию комплекта средств оценки и развертывания Windows (Windows ADK). Вы можете обслуживать или настраивать загрузочные образы, если они основаны на версии Windows PE из поддерживаемой версии Windows ADK.

Дополнительные сведения см. в статье Управление образами загрузки с помощью Configuration Manager.

Примечание.

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

Примеры

Пример 1. Переименование загрузочного образа

Эта команда получает загрузочный образ по идентификатору пакета, а затем переименовывает его.

Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"

Пример 2. Задание описательных свойств

Эта команда получает загрузочный образ по имени, а затем добавляет в него версию и описание.

Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"

Пример 3. Установка раскладки клавиатуры

В следующем примере раскладка клавиатуры загрузочного образа по умолчанию устанавливается на русский (Русский) язык. Он идентифицирует загрузочный образ по его идентификатору.

Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"

Пример 4. Добавление необязательных компонентов

В этом примере показано, как получить необязательные компоненты .NET и PowerShell, а затем добавить их в загрузочный образ.

$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)

Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs

Параметры

-AddOptionalComponent

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

Обычно используются следующие компоненты:

Microsoft .NET (WinPE-NetFX): этот компонент является необходимым условием для PowerShell. Это один из более крупных необязательных компонентов.
Windows PowerShell (WinPE-PowerShell). Для этого компонента требуется .NET и добавлена ограниченная поддержка PowerShell. Если вы запускаете пользовательские скрипты PowerShell на этапе WinPE последовательности задач, добавьте этот компонент. Существуют и другие компоненты, которые могут потребоваться для других командлетов PowerShell.
HTML (WinPE-HTA): если вы запускаете пользовательские приложения HTML на этапе WinPE последовательности задач, добавьте этот компонент.

Дополнительные сведения см. в разделе Управление загрузочными образами — необязательные компоненты.

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

-BackgroundBitmapPath

Укажите сетевой путь к файлу пользовательского фонового изображения для использования в Среде предустановки Windows.

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

-Confirm

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

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

-CopyToPackageShareOnDistributionPoint

Клиенты всегда могут скачать образ загрузки из точки распространения. Если задать для этого параметра значение $true, сайт сделает его доступным через именованный сетевой ресурс в точках распространения. Используйте CustomPackageShareName , чтобы указать пользовательское имя общей папки.

При включении этого параметра в точках распространения требуется больше места. Он применяется ко всем точкам распространения, к которым распространяется этот образ загрузки.

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

-CustomPackageShareName

Если вы включите CopyToPackageShareOnDistributionPoint, этот параметр можно использовать для настройки имени общей папки. Максимальная длина составляет 127 символов и не может содержать следующие символы: " / [ ] : | < > + = ; , ? *. Можно указать имя общей папки и имя папки, но максимальное значение для каждого из них — 80 символов. Например, ShareName\FolderName.

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

-DeployFromPxeDistributionPoint

Задайте для этого параметра значение $true , чтобы сделать этот загрузочный образ доступным из точки распространения с поддержкой PXE. Дополнительные сведения см . в статье Использование PXE для развертывания Windows по сети.

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

-Description

Укажите необязательное описание загрузочного образа, чтобы его определить.

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

-DisableWildcardHandling

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

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

-DisconnectUserFromDistributionPoint

Этот параметр не рекомендуется. Он задает свойство ForcedDisconnectEnabled загрузочного образа.

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

-DisconnectUserFromDistributionPointMins

Этот параметр не рекомендуется. Он задает свойство ForcedDisconnectDelay загрузочного образа.

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

-DisconnectUserFromDistributionPointRetryCount

Этот параметр не рекомендуется. Он задает свойство ForcedDisconnectNumRetries загрузочного образа.

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

-DistributionPointUpdateSchedule

Используйте этот параметр для обновления точек распространения по расписанию. Чтобы получить объект schedule, используйте командлет New-CMSchedule .

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

-EnableBinaryDeltaReplication

Задайте для этого параметра значение $true , чтобы включить двоичную разностную репликацию (BDR). Дополнительные сведения см. в статье Основные понятия управления содержимым в Configuration Manager.

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

-EnableCommandSupport

В нерабочих, только тестовых средах для этого параметра можно задать $true , чтобы включить поддержку команд. Когда устройство загружает этот образ, можно нажать клавишу F8 , чтобы открыть командную строку администратора. Этот параметр полезен для устранения неполадок во время тестирования развертывания. Использовать этот параметр в рабочем развертывании не рекомендуется из-за проблем с безопасностью.

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

-EnablePrestartCommand

Задайте для этого параметра значение $true , чтобы включить команду перед запуском. Эта командная строка запускается перед запуском последовательности задач.

Также настройте следующие параметры: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.

Тип:	Boolean
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

-Id

Укажите идентификатор образа загрузки для настройки. Это значение является стандартным идентификатором пакета, например : XYZ00002.

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

-IncludeFilesForPrestart

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

Например, если вы хотите запустить пакетный скрипт, используйте этот параметр, чтобы включить файл скрипта.

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

-InputLocale

Этот параметр используется для настройки раскладки клавиатуры по умолчанию для загрузочного образа. Укажите тег языка. Например, чтобы задать для входного языкового стандарта значение Русский (Россия), укажите строку ru-ru. Дополнительные сведения см. в разделе [MS-LCID]: Справочник по идентификатору кода языка Windows (LCID).

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

-InputObject

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

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

-Name

Укажите имя загрузочного образа для настройки.

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

-NewName

Укажите новое имя загрузочного образа.

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

-PassThru

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

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

-Path

Укажите сетевой путь образа Windows PE, который используется в этом загрузочном образе. Невозможно изменить путь для образов загрузки по умолчанию.

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

-PersistContentInCache

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

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

-PrestageBehavior

Укажите поведение при включении точки распространения для предварительно подготовленного содержимого:

ManualCopy: вручную скопируйте содержимое этого пакета в точку распространения.
DownloadDelta: скачивание только изменений содержимого в точку распространения
OnDemand: автоматическое скачивание содержимого при назначении пакетов точкам распространения

Дополнительные сведения см. в разделе Использование предварительно подготовленного содержимого.

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

-PrestartCommandLine

Если включить EnablePrestartCommand, используйте этот параметр, чтобы указать командную строку для запуска. Максимальная длина составляет 4096 символа.

Если в командной строке требуются файлы, которые не входят в windows PE, используйте параметры IncludeFilesForPrestart и PrestartIncludeFilesDirectory .

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

-PrestartIncludeFilesDirectory

Если включить EnablePrestartCommand и IncludeFilesForPrestart, используйте этот параметр, чтобы указать сетевой путь к файлам, которые нужно включить в образ загрузки.

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

-Priority

Укажите порядок, в котором сайт отправляет содержимое другим сайтам и точкам распространения на этом сайте.

Сайт отправляет содержимое с высоким приоритетом перед пакетами со средним или низким приоритетом. Пакеты с равным приоритетом отправляются в том порядке, в котором они создаются.

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

-Reload

Применяется к версии 2006 и более поздним. Если версии компонентов Windows ADK в загрузочном образе устарели, добавьте этот параметр, чтобы перезагрузить загрузочный образ с текущей версией Windows PE из Windows ADK. Дополнительные сведения см. в разделе Обновление точек распространения с помощью загрузочного образа.

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

-RemoveOptionalComponent

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

Не удаляйте следующие компоненты, необходимые для Configuration Manager:

Скрипты (WinPE-Scripting)
Запуск (WinPE-SecureStartup)
Сеть (WinPE-WDS-Tools)
Скрипты (WinPE-WMI)

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

-ScratchSpace

Настройте пространство среды предустановки Windows, которое является временным хранилищем (ОЗУ), используемым WinPE. Например, если приложение выполняется в WinPE и должно записывать временные файлы, WinPE перенаправляет файлы в пространство в памяти, чтобы имитировать наличие жесткого диска. По умолчанию этот объем составляет 512 МБ для устройств с более чем 1 ГБ ОЗУ, в противном случае значение по умолчанию — 32 МБ.

Тип:	UInt32
Допустимые значения:	32, 64, 128, 256, 512
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SendToPreferredDistributionPoint

Если вы хотите включить распространение содержимого по запросу в предпочтительные точки распространения, задайте для этого параметра значение $true. Если этот параметр включен, если клиент запрашивает содержимое для пакета и содержимое недоступно ни в каких точках распространения, точка управления распространяет содержимое. Дополнительные сведения см. в разделе Распространение содержимого по запросу.

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

-Version

Укажите версию загрузочного образа. Это значение не является версией ОС, а строкой, управляемой вами.

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object

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