Set-CMBootImage
Изменение образа загрузки ОС.
Синтаксис
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 последовательности задач, добавьте этот компонент.
Дополнительные сведения см. в разделе Управление загрузочными образами — необязательные компоненты.
| Type: | IResultObject[] |
| Aliases: | AddOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackgroundBitmapPath
Укажите сетевой путь к файлу пользовательского фонового изображения, который будет использоваться в Среде предустановки Windows.
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
Клиенты всегда могут скачать образ загрузки из точки распространения. Если задать для этого параметра значение $true, сайт сделает его доступным через именованный сетевой ресурс в точках распространения. Используйте CustomPackageShareName , чтобы указать пользовательское имя общей папки.
При включении этого параметра в точках распространения требуется больше места. Он применяется ко всем точкам распространения, к которым распространяется этот образ загрузки.
| Type: | Boolean |
| Aliases: | CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomPackageShareName
Если вы включите CopyToPackageShareOnDistributionPoint, этот параметр можно использовать для настройки имени общей папки. Максимальная длина составляет 127 символов и не может содержать следующие символы: " / [ ] : | < > + = ; , ? *. Можно указать имя общей папки и имя папки, но максимальное значение для каждого из них — 80 символов. Например, ShareName\FolderName.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeployFromPxeDistributionPoint
Задайте для этого параметра значение $true , чтобы сделать этот загрузочный образ доступным из точки распространения с поддержкой PXE. Дополнительные сведения см . в статье Использование PXE для развертывания Windows по сети.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Укажите необязательное описание загрузочного образа, чтобы его определить.
| 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 |
-DisconnectUserFromDistributionPoint
Этот параметр не рекомендуется использовать. Он задает свойство ForcedDisconnectEnabled загрузочного образа.
| Type: | Boolean |
| Aliases: | DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
Этот параметр не рекомендуется использовать. Он задает свойство ForcedDisconnectDelay загрузочного образа.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetryCount
Этот параметр не рекомендуется использовать. Он задает свойство ForcedDisconnectNumRetries загрузочного образа.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
Используйте этот параметр для обновления точек распространения по расписанию. Чтобы получить объект schedule, используйте командлет New-CMSchedule .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
Присвойте этому параметру значение $true , чтобы включить двоичную разностную репликацию (BDR). Дополнительные сведения см. в статье Основные понятия управления содержимым в Configuration Manager.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableCommandSupport
В нерабочих, только тестовых средах для этого параметра можно задать $true , чтобы включить поддержку команд. Когда устройство загружает этот образ, можно нажать клавишу F8 , чтобы открыть командную строку администратора. Этот параметр полезен для устранения неполадок во время тестирования развертывания. Использовать этот параметр в рабочем развертывании не рекомендуется из-за проблем с безопасностью.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnablePrestartCommand
Задайте для этого параметра значение $true , чтобы включить команду перед запуском. Эта командная строка запускается перед запуском последовательности задач.
Также настройте следующие параметры: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.
| Type: | Boolean |
| 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 |
-Id
Укажите идентификатор образа загрузки для настройки. Это значение является стандартным идентификатором пакета, например : XYZ00002.
| Type: | String |
| Aliases: | PackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeFilesForPrestart
Если включен параметр EnablePrestartCommand, используйте этот параметр, если для выполнения команды перед запуском требуются другие файлы. Затем используйте параметр PrestartIncludeFilesDirectory , чтобы указать расположение файлов для включения.
Например, если вы хотите запустить пакетный скрипт, используйте этот параметр, чтобы включить файл скрипта.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputLocale
Этот параметр используется для настройки раскладки клавиатуры по умолчанию для загрузочного образа. Укажите тег языка. Например, чтобы задать для входного языкового стандарта значение Русский (Россия), укажите строку ru-ru. Дополнительные сведения см. в разделе [MS-LCID]: Справочник по идентификатору кода языка Windows (LCID).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Укажите объект образа загрузки для настройки. Чтобы получить этот объект, используйте командлет Get-CMBootImage .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Укажите имя загрузочного образа для настройки.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Укажите новое имя загрузочного образа.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Укажите сетевой путь образа Windows PE, который используется в этом загрузочном образе. Невозможно изменить путь для образов загрузки по умолчанию.
| Type: | String |
| Aliases: | ImagePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistContentInCache
Если вы не хотите, чтобы содержимое этого пакета выстаревало из кэша клиента, чтобы освободить место для другого содержимого, задайте для этого параметра значение $true , чтобы сохранить его в кэше клиента.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestageBehavior
Укажите поведение при включении точки распространения для предварительно подготовленного содержимого:
ManualCopy: вручную скопируйте содержимое этого пакета в точку распространения.DownloadDelta: скачивание только изменений содержимого в точку распространенияOnDemand: автоматическое скачивание содержимого при назначении пакетов точкам распространения
Дополнительные сведения см. в разделе Использование предварительно подготовленного содержимого.
| Type: | PrestageBehavior |
| Accepted values: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartCommandLine
Если включить EnablePrestartCommand, используйте этот параметр, чтобы указать командную строку для запуска. Максимальная длина составляет 4096 символа.
Если в командной строке требуются файлы, которые не входят в windows PE, используйте параметры IncludeFilesForPrestart и PrestartIncludeFilesDirectory .
| Type: | String |
| Aliases: | CommandLine |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartIncludeFilesDirectory
Если включить EnablePrestartCommand и IncludeFilesForPrestart, используйте этот параметр, чтобы указать сетевой путь к файлам, которые нужно включить в образ загрузки.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
Укажите порядок, в котором сайт отправляет содержимое другим сайтам и точкам распространения на этом сайте.
Сайт отправляет содержимое с высоким приоритетом перед пакетами со средним или низким приоритетом. Пакеты с равным приоритетом отправляются в том порядке, в котором они создаются.
| Type: | Priority |
| Accepted values: | High, Medium, Low |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reload
Применяется к версии 2006 и более поздним. Если версии компонентов Windows ADK в загрузочном образе устарели, добавьте этот параметр, чтобы перезагрузить загрузочный образ с текущей версией Windows PE из Windows ADK. Дополнительные сведения см. в разделе Обновление точек распространения с помощью загрузочного образа.
| Type: | SwitchParameter |
| Aliases: | ReloadImage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOptionalComponent
Укажите массив необязательных объектов компонентов для удаления из загрузочного образа. Чтобы получить этот объект, используйте командлет Get-CMWinPEOptionalComponentInfo .
Не удаляйте следующие компоненты, необходимые для Configuration Manager:
- Скрипты (WinPE-Scripting)
- Запуск (WinPE-SecureStartup)
- Сеть (WinPE-WDS-Tools)
- Скрипты (WinPE-WMI)
| Type: | IResultObject[] |
| Aliases: | RemoveOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScratchSpace
Настройте пространство среды предустановки Windows, которое является временным хранилищем (ОЗУ), используемым WinPE. Например, если приложение выполняется в WinPE и требует записи временных файлов, WinPE перенаправляет файлы в пространство в памяти, чтобы имитировать наличие жесткого диска. По умолчанию этот объем составляет 512 МБ для устройств с более чем 1 ГБ ОЗУ, в противном случае значение по умолчанию — 32 МБ.
| Type: | UInt32 |
| Accepted values: | 32, 64, 128, 256, 512 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendToPreferredDistributionPoint
Если вы хотите включить распространение содержимого по запросу в предпочтительные точки распространения, задайте для этого параметра значение $true. Если этот параметр включен, если клиент запрашивает содержимое для пакета и содержимое недоступно ни в одной точке распространения, точка управления распространяет содержимое. Дополнительные сведения см. в разделе Распространение содержимого по запросу.
| Type: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
Укажите версию загрузочного образа. Это значение не является версией ОС, а строкой, управляемой вами.
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object
Связанные ссылки
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по