Set-CMBootImage
修改 OS 開機映射。
Syntax
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>] Description
使用此 Cmdlet 來修改 OS 開機映射。 開機映射是 Windows 預先安裝環境 (Windows PE) 映射，您會在安裝 OS 之前將用戶端電腦開機到其中。
您可以將設備磁碟機新增至開機映射或變更其屬性。 您必須先將驅動程式匯入到Configuration Manager驅動程式目錄並加以啟用，才能新增設備磁碟機。
每個版本的Configuration Manager都支援 Windows ADK) (Windows 評定及部署套件的特定版本。 當開機映射是以支援的 Windows ADK 版本中的 Windows PE 版本為基礎時，您可以提供服務或自訂開機映射。
如需詳細資訊，請參閱使用 Configuration Manager 管理開機映射。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 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 Cmdlet。
下列元件是常用的：
- Microsoft .NET (WinPE-NetFX) ：此元件是 PowerShell 的必要條件。 它是其中一個較大的選擇性元件。
- Windows PowerShell (WinPE-PowerShell) ：此元件需要 .NET，並新增有限的 PowerShell 支援。 如果您在工作順序的 WinPE 階段執行自訂 PowerShell 腳本，請新增此元件。 其他 PowerShell Cmdlet 可能需要其他元件。
- HTML (WinPE-HTA) ：如果您在工作順序的 WinPE 階段執行自訂 HTML 應用程式，請新增此元件。
如需詳細資訊，請 參閱管理開機映射 - 選擇性元件。
| Type: | IResultObject[] |
| Aliases: | AddOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackgroundBitmapPath
指定要在 Windows PE 中使用的自訂背景影像檔的網路檔案路徑。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 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
使用此參數可依排程更新發佈點。 若要取得排程物件，請使用 New-CMSchedule Cmdlet。
| 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 Cmdlet。
| 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
新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| 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 ADK 重載目前 Windows PE 版本的開機映射。 如需詳細資訊，請參閱 使用開機映射更新發佈點。
| Type: | SwitchParameter |
| Aliases: | ReloadImage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOptionalComponent
指定要從開機映射中移除的選擇性元件物件陣列。 若要取得此物件，請使用 Get-CMWinPEOptionalComponentInfo Cmdlet。
請勿移除Configuration Manager所需的下列元件：
- WinPE 腳本 (腳本)
- 啟動 (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 PE 臨時空間，這是 WinPE 所) (RAM 磁碟磁碟機的暫存儲存體。 例如，當應用程式在 WinPE 內執行且需要寫入暫存檔時，WinPE 會將檔案重新導向至記憶體中的臨時空間，以模擬硬碟的存在。 根據預設，對於 RAM 超過 1 GB 的裝置，此數量為 512 MB，否則預設值為 32 MB。
| 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
指定開機映射的版本。 此值不是 OS 版本，而是您管理的字串。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 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 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應