次の方法で共有

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 でブート イメージを管理する」を参照してください。

注:

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

例

例 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