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>]

説明

OS ブートイメージを変更するには、このコマンドレットを使用します。ブートイメージは、OS をインストールする前にクライアントコンピューターを起動する Windows プレインストール環境 (Windows PE) イメージです。

ブートイメージにデバイスドライバーを追加したり、そのプロパティを変更したりできます。新しいデバイスドライバーを追加する前に、ドライバーをConfiguration Manager ドライバーカタログにインポートして有効にする必要があります。

Configuration Managerの各バージョンでは、特定のバージョンの Windows Assessment and Deployment Kit (Windows ADK) がサポートされています。サポートされているバージョンの Windows ADK の Windows PE バージョンに基づいている場合は、ブートイメージをサービスまたはカスタマイズできます。

詳細については、「Configuration Managerを使用してブートイメージを管理する」を参照してください。

注:

Configuration Manager サイトドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。詳細については、「作業の開始」を参照してください。

例

例 1: ブートイメージの名前を変更する

このコマンドは、パッケージ ID によってブートイメージを取得し、名前を変更します。

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: キーボードレイアウトを設定する

次の例では、ブートイメージの既定のキーボードレイアウトを ロシア語 (ロシア) 言語に設定します。ブートイメージを ID で識別します。

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 の前提条件です。これは、より大きなオプションコンポーネントの1つです。
Windows PowerShell (WinPE-PowerShell): このコンポーネントには .NET が必要であり、制限付きの PowerShell サポートが追加されます。タスクシーケンスの WinPE フェーズでカスタム PowerShell スクリプトを実行する場合は、このコンポーネントを追加します。他の PowerShell コマンドレットに必要なコンポーネントは他にもあります。
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

コマンドレットを実行する前に確認メッセージを表示します。

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

PXE 対応配布ポイントからこのブートイメージを使用できるようにするには、このパラメーターを $true に設定します。詳細については、「 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

バイナリ差分レプリケーション (BDR) を有効にするには、このパラメーターを $true に設定します。詳細については、「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

構成するブートイメージ ID を指定します。この値は、標準パッケージ 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 を有効にする場合は、このパラメーターを使用して、実行するコマンドラインを指定します。最大長は 4,096 文字です。

コマンドラインで 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 コマンドレットを使用します。

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

WinPE で使用される一時記憶域 (RAM ドライブ) である Windows PE スクラッチ領域を構成します。たとえば、アプリケーションが 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

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

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