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 アプリケーションを実行する場合は、このコンポーネントを追加します。

詳細については、「ブートイメージの管理 - 省略可能なコンポーネント」を参照してください。

型:	IResultObject[]
Aliases:	AddOptionalComponents
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-BackgroundBitmapPath

Windows PE で使用するカスタム背景画像ファイルのネットワークファイルパスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CopyToPackageShareOnDistributionPoint

クライアントは、常に配布ポイントからブートイメージをダウンロードできます。このパラメーターを $true に設定すると、サイトは配布ポイント上の名前付きネットワーク共有を介して使用できるようにします。 CustomPackageShareName を使用して、カスタム共有名を指定します。

このオプションを有効にすると、配布ポイントにさらに多くの領域が必要になります。これは、このブートイメージを配布するすべての配布ポイントに適用されます。

型:	Boolean
Aliases:	CopyToPackageShareOnDistributionPoints
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CustomPackageShareName

CopyToPackageShareOnDistributionPoint を有効にした場合は、このパラメーターを使用して共有名をカスタマイズできます。最大長は 127 文字で、次の文字を含めることはできません。 " / [ ] : | < > + = ; , ? * 共有名とフォルダー名を指定できますが、それぞれの最大文字数は 80 文字です。たとえば、「 ShareName\FolderName 」のように入力します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeployFromPxeDistributionPoint

PXE 対応配布ポイントからこのブートイメージを使用できるようにするには、このパラメーターを $true に設定します。詳細については、「 PXE を使用してネットワーク経由で Windows を展開する」を参照してください。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

ブートイメージを識別するのに役立つ、ブートイメージの説明 (省略可能) を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisconnectUserFromDistributionPoint

このオプションは非推奨です。ブートイメージの ForcedDisconnectEnabled プロパティを設定します。

型:	Boolean
Aliases:	DisconnectUsersFromDistributionPoints
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisconnectUserFromDistributionPointMins

このオプションは非推奨です。ブートイメージの ForcedDisconnectDelay プロパティを設定します。

型:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsMinutes
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisconnectUserFromDistributionPointRetryCount

このオプションは非推奨です。ブートイメージの ForcedDisconnectNumRetries プロパティを設定します。

型:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsRetries
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DistributionPointUpdateSchedule

スケジュールに従って配布ポイントを更新するには、このパラメーターを使用します。 schedule オブジェクトを取得するには、 New-CMSchedule コマンドレットを使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableBinaryDeltaReplication

バイナリ差分レプリケーション (BDR) を有効にするには、このパラメーターを $true に設定します。詳細については、「Configuration Managerでのコンテンツ管理の基本的な概念」を参照してください。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableCommandSupport

運用環境以外のテスト環境でのみ、このパラメーターを $true に設定してコマンドサポートを有効にすることができます。デバイスがこのイメージを起動すると、 F8 キーを押して管理コマンドプロンプトを開くことができます。このオプションは、デプロイのテスト中のトラブルシューティングに役立ちます。運用環境のデプロイでこの設定を使用することは、セキュリティ上の懸念があるため、お勧めできません。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnablePrestartCommand

このパラメーターを $true に設定して、事前開始コマンドを有効にします。このコマンドラインは、タスクシーケンスが開始される前に実行されます。

また、 IncludeFilesForPrestart、 PrestartCommandLine、 PrestartIncludeFilesDirectory というパラメーターも構成します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

確認を求めずにコマンドを実行します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

構成するブートイメージ ID を指定します。この値は、標準パッケージ ID です (例: XYZ00002)。

型:	String
Aliases:	PackageId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IncludeFilesForPrestart

EnablePrestartCommand を有効にする場合は、事前開始コマンドで他のファイルを実行する必要がある場合は、このパラメーターを使用します。次に、 PrestartIncludeFilesDirectory パラメーターを使用して、含めるファイルの場所を指定します。

たとえば、バッチスクリプトを実行する場合は、このオプションを使用してスクリプトファイルを含めます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputLocale

ブートイメージの既定のキーボードレイアウトを構成するには、このパラメーターを使用します。 言語タグを指定します。たとえば、入力ロケールをロシア語 (ロシア) に設定するには、文字列を指定します ru-ru。詳細については、「 [MS-LCID]: Windows 言語コード識別子 (LCID) リファレンス」を参照してください。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

構成するブートイメージオブジェクトを指定します。このオブジェクトを取得するには、 Get-CMBootImage コマンドレットを使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

構成するブートイメージの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NewName

ブートイメージの新しい名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。既定では、このコマンドレットは出力を生成しない場合があります。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

このブートイメージで使用する Windows PE イメージのネットワークパスを指定します。既定のブートイメージのパスを変更することはできません。

型:	String
Aliases:	ImagePath
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PersistContentInCache

このパッケージのコンテンツをクライアントキャッシュから除外して他のコンテンツの領域を作り出したくない場合は、このパラメーターを $true に設定してクライアントキャッシュに保持します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PrestageBehavior

事前設定されたコンテンツの配布ポイントを有効にする場合の動作を指定します。

ManualCopy: このパッケージ内のコンテンツを配布ポイントに手動でコピーします。
DownloadDelta: コンテンツの変更のみを配布ポイントにダウンロードする
OnDemand: パッケージが配布ポイントに割り当てられると、コンテンツが自動的にダウンロードされます

詳細については、「事前設定されたコンテンツを使用する」を参照してください。

型:	PrestageBehavior
指定可能な値:	ManualCopy, DownloadDelta, OnDemand
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PrestartCommandLine

EnablePrestartCommand を有効にする場合は、このパラメーターを使用して、実行するコマンドラインを指定します。最大長は 4,096 文字です。

コマンドラインで Windows PE にないファイルが必要な場合は、 IncludeFilesForPrestart パラメーターと PrestartIncludeFilesDirectory パラメーターを 使用します。

型:	String
Aliases:	CommandLine
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PrestartIncludeFilesDirectory

EnablePrestartCommand と IncludeFilesForPrestart を有効にする場合は、このパラメーターを使用して、ブートイメージに含めるファイルのネットワークパスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Priority

サイトが他のサイトとこのサイトの配布ポイントにコンテンツを送信する順序を指定します。

サイトは、優先度の高いコンテンツを中または低の優先順位のパッケージの前に送信します。優先度が等しいパッケージは、作成された順序で送信されます。

型:	Priority
指定可能な値:	High, Medium, Low
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Reload

バージョン 2006 以降に適用されます。ブートイメージ内の Windows ADK コンポーネントのバージョンが古い場合は、このパラメーターを追加して、Windows ADK の現在の Windows PE バージョンでブートイメージを再読み込みします。詳細については、「ブートイメージを使用して配布ポイントを更新する」を参照してください。

型:	SwitchParameter
Aliases:	ReloadImage
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveOptionalComponent

ブートイメージから削除するオプションのコンポーネントオブジェクトの配列を指定します。このオブジェクトを取得するには、 Get-CMWinPEOptionalComponentInfo コマンドレットを使用します。

Configuration Managerで必要な次のコンポーネントは削除しないでください。

スクリプティング (WinPE-Scripting)
スタートアップ (WinPE-SecureStartup)
ネットワーク (WinPE-WDS-Tools)
スクリプト (WinPE-WMI)

型:	IResultObject[]
Aliases:	RemoveOptionalComponents
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScratchSpace

WinPE で使用される一時記憶域 (RAM ドライブ) である Windows PE スクラッチ領域を構成します。たとえば、アプリケーションが WinPE 内で実行され、一時ファイルを書き込む必要がある場合、WinPE はファイルをメモリ内のスクラッチ領域にリダイレクトして、ハードディスクの存在をシミュレートします。既定では、RAM が 1 GB を超えるデバイスの場合、この量は 512 MB です。それ以外の場合、既定値は 32 MB です。

型:	UInt32
指定可能な値:	32, 64, 128, 256, 512
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SendToPreferredDistributionPoint

優先配布ポイントへのオンデマンドコンテンツ配布を有効にする場合は、このパラメーターを $true に設定します。この設定を有効にすると、クライアントがパッケージのコンテンツを要求し、そのコンテンツが配布ポイントで使用できない場合、管理ポイントはコンテンツを配布します。詳細については、「オンデマンドコンテンツの配布」を参照してください。

型:	Boolean
Aliases:	SendToPreferredDistributionPoints
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Version

ブートイメージのバージョンを指定します。この値は OS バージョンではなく、管理する文字列です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

次の方法で共有