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 ブート イメージを変更します。 ブート イメージはWindowsインストール環境 (WINDOWS PE) イメージで構成され、OS をインストールする前にクライアント コンピューターを起動します。

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

Configuration Manager の各バージョンでは、評価と展開キット (Windows ADK) の特定Windowsサポートされています。 サポートされているバージョンの ADK から、Windows PE バージョンに基づいてイメージをWindowsできます。

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

注意

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

例

例 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
Accept pipeline input:False
Accept wildcard characters:False
-BackgroundBitmapPath

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CopyToPackageShareOnDistributionPoint

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

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

Type:Boolean
Aliases:CopyToPackageShareOnDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CustomPackageShareName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeployFromPxeDistributionPoint

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

ブート イメージの識別に役立つ、オプションのブート イメージの説明を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPoint

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

Type:Boolean
Aliases:DisconnectUsersFromDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointMins

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

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointRetryCount

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

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsRetries
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointUpdateSchedule

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableBinaryDeltaReplication

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableCommandSupport

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnablePrestartCommand

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

また、次のパラメーターを構成します。 IncludeFilesForPrestart、 PrestartCommandLine、 PrestartIncludeFilesDirectory。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Id

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

Type:String
Aliases:PackageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IncludeFilesForPrestart

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

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputLocale

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Path

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

Type:String
Aliases:ImagePath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PersistContentInCache

このパッケージのコンテンツをクライアント キャッシュからエイズアウトして他のコンテンツを保存しない場合は、このパラメーターを $true に設定して、クライアント キャッシュに保持します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestageBehavior

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

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

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

Type:PrestageBehavior
Accepted values:ManualCopy, DownloadDelta, OnDemand
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestartCommandLine

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

コマンド ラインで PE に含Windowsする場合は 、IncludeFilesForPrestartパラメーターとPrestartIncludeFilesDirectory パラメーターを使用します。

Type:String
Aliases:CommandLine
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestartIncludeFilesDirectory

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Priority

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

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

Type:Priority
Accepted values:High, Medium, Low
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
-ScratchSpace

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

Type:UInt32
Accepted values:32, 64, 128, 256, 512
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendToPreferredDistributionPoint

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

Type:Boolean
Aliases:SendToPreferredDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Version

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object