Set-CMBootImage

參考

模組:: ConfigurationManager

修改OS開機映像。

語法

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 應用程式，請新增此元件。

如需詳細資訊，請參閱管理開機映射 - 選擇性元件。

類型:	IResultObject[]
別名:	AddOptionalComponents
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BackgroundBitmapPath

指定要在 Windows PE 中使用的自訂背景影像檔的網路檔案路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CopyToPackageShareOnDistributionPoint

用戶端一律可以從發佈點下載開機映像。如果您將此參數設定為 $true，月臺會透過發佈點上的具名網路共用提供此參數。使用 CustomPackageShareName 指定自定義共用名。

當您啟用此選項時，發佈點上需要更多空間。它適用於您發佈此開機映像的所有發佈點。

類型:	Boolean
別名:	CopyToPackageShareOnDistributionPoints
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CustomPackageShareName

如果您啟用 CopyToPackageShareOnDistributionPoint，您可以使用此參數來自定義共用名。最大長度為 127 個字元，且不能包含下列任何字元： " / [ ] : | < > + = ; , ? *。您可以指定共用名和資料夾名稱，但每個名稱的上限為80個字元。例如，ShareName\FolderName。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeployFromPxeDistributionPoint

將此參數設定為 $true ，讓此開機映像可從已啟用 PXE 的發佈點使用。如需詳細資訊，請參閱使用 PXE 透過網路部署 Windows。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

指定開機映像的選擇性描述，以協助您識別它。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisconnectUserFromDistributionPoint

此選項已被取代。它會設定開機映像的 ForcedDisconnectEnabled 屬性。

類型:	Boolean
別名:	DisconnectUsersFromDistributionPoints
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisconnectUserFromDistributionPointMins

此選項已被取代。它會設定開機映像的 ForcedDisconnectDelay 屬性。

類型:	UInt32
別名:	DisconnectUsersFromDistributionPointsMinutes
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisconnectUserFromDistributionPointRetryCount

此選項已被取代。它會設定開機映像的 ForcedDisconnectNumRetries 屬性。

類型:	UInt32
別名:	DisconnectUsersFromDistributionPointsRetries
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DistributionPointUpdateSchedule

使用此參數可依排程更新發佈點。若要取得排程物件，請使用 New-CMSchedule Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableBinaryDeltaReplication

將此參數設定為 $true ，以啟用 BDR) (二進位差異複寫。如需詳細資訊，請參閱 Configuration Manager 中內容管理的基本概念。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableCommandSupport

在非生產環境中，您可以將此參數設定為 $true ，以啟用命令支援。當裝置開機到此映射時，您可以按 F8 開啟系統管理命令提示字元。此選項適用於測試部署時的疑難解答。基於安全性考慮，建議您不要在生產環境部署中使用此設定。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnablePrestartCommand

將此參數設定為 $true 以啟用啟動前置命令。此命令行會在工作順序開始之前執行。

同時設定下列參數： IncludeFilesForPrestart、 PrestartCommandLine、 PrestartIncludeFilesDirectory。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

執行命令而不要求確認。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定要設定的開機映像標識碼。此值是標準套件標識碼，例如： XYZ00002。

類型:	String
別名:	PackageId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-IncludeFilesForPrestart

如果您啟用 EnablePrestartCommand，如果您的啟動前置命令需要執行其他檔案，請使用此參數。然後使用 PrestartIncludeFilesDirectory 參數來指定要包含的檔案位置。

例如，如果您想要執行批次腳本，請使用此選項來包含腳本檔案。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputLocale

使用此參數來設定開機映像的默認鍵盤配置。指定 語言標記。例如，若要將輸入地區設定設為俄 (俄羅斯) ，請指定字串 ru-ru。如需詳細資訊，請參閱 [MS-LCID]： Windows 語言代碼識別碼 (LCID) 參考。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定要設定的開機映像物件。若要取得此物件，請使用 Get-CMBootImage Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

指定要設定的開機映像名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NewName

指定開機映像的新名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

新增此參數以傳回物件，代表您正在使用的專案。根據預設，此 Cmdlet 可能不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

指定此開機映像所使用之 Windows PE 映像的網路路徑。您無法變更預設開機映像的路徑。

類型:	String
別名:	ImagePath
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PersistContentInCache

如果您不想讓此套件的內容離開用戶端快取，以騰出空間供其他內容使用，請將此參數設定為 $true 將它保存在用戶端快取中。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrestageBehavior

當您啟用預先設定內容的發佈點時，請指定行為：

ManualCopy：手動將此套件中的內容複製到發佈點
DownloadDelta：僅下載發佈點的內容變更
OnDemand：將套件指派給發佈點時自動下載內容

如需詳細資訊，請參閱使用預先設置的內容。

類型:	PrestageBehavior
接受的值:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrestartCommandLine

如果您啟用 EnablePrestartCommand，請使用此參數來指定要執行的命令行。長度上限是 4096 個字元。

如果命令行需要不在 Windows PE 中的檔案，請使用 IncludeFilesForPrestart 和 PrestartIncludeFilesDirectory 參數。

類型:	String
別名:	CommandLine
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrestartIncludeFilesDirectory

如果您啟用 EnablePrestartCommand 和 IncludeFilesForPrestart，請使用此參數來指定要包含在開機映像中的檔案網路路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Priority

指定網站將內容傳送至此網站中其他網站和發佈點的順序。

網站會先傳送高優先順序的內容，再傳送中低優先順序的套件。優先順序相等的套件會依其建立順序傳送。

類型:	Priority
接受的值:	High, Medium, Low
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Reload

適用於 2006 版和更新版本。如果開機映射中的 Windows ADK 元件版本已過期，請新增此參數，以從 Windows ADK 重載目前 Windows PE 版本的開機映射。如需詳細資訊，請參閱使用開機映射更新發佈點。

類型:	SwitchParameter
別名:	ReloadImage
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveOptionalComponent

指定要從開機映像中移除的選擇性元件物件數位。若要取得此物件，請使用 Get-CMWinPEOptionalComponentInfo Cmdlet。

請勿移除 Configuration Manager 所需的下列元件：

WinPE 腳本 (腳本)
啟動 (WinPE-SecureStartup)
網路 (WinPE-WDS-Tools)
撰寫 WinPE-WMI) (腳本

類型:	IResultObject[]
別名:	RemoveOptionalComponents
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ScratchSpace

設定 Windows PE 臨時空間，這是 WinPE 所使用 (RAM 磁碟驅動器) 暫存記憶體。例如，當應用程式在 WinPE 內執行且需要寫入暫存盤時，WinPE 會將檔案重新導向至記憶體中的臨時空間，以模擬硬碟是否存在。根據預設，對於 RAM 超過 1 GB 的裝置，此數量為 512 MB，否則預設值為 32 MB。

類型:	UInt32
接受的值:	32, 64, 128, 256, 512
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SendToPreferredDistributionPoint

如果您想要啟用對慣用發佈點的隨選內容發佈，請將此參數設定 為 $true。當您啟用此設定時，如果用戶端要求套件的內容，且內容無法在任何發佈點上使用，則管理點會發佈內容。如需詳細資訊，請參閱隨選內容發佈。

類型:	Boolean
別名:	SendToPreferredDistributionPoints
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Version

指定開機映像的版本。此值不是 OS 版本，而是您管理的字串。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

共用方式為