New-CMOperatingSystemImage

OS イメージを作成します。

構文

New-CMOperatingSystemImage
   [-Description <String>]
   -Name <String>
   -Path <String>
   [-Index <Int32>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、構成マネージャー サイトに OS イメージを追加します。 OS イメージは、参照ファイルとフォルダーの圧縮コレクションを表す WIM ファイルです。 Configuration Manager は、これらのイメージをタスク シーケンスと一緒に使用して、コンピューターに OS を展開します。 詳細については 、「Configuration Manager を使用して OS イメージを管理する」を参照してください

注意

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

例 1: OS イメージを作成する

このコマンドは、ネットワーク パスから OS イメージのインストール ソース ファイルWindows 10"Windows 10"という名前の OS イメージを作成します。

New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"

パラメーター

-Confirm

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

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

画像の識別に役立つオプションの説明を指定します。 最大長は 127 文字です。

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

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

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

このパラメーターを追加すると、サイトは複数インデックス イメージから 1 つのインデックス イメージを抽出します。 次に、新しいイメージを元のイメージと同じソース フォルダーに格納します。

このオプションを使用すると、イメージ ファイルが小さくなります。オフライン サービスが高速になります。 また、ソフトウェア更新プログラムを 適用した後、小さいイメージ ファイルのイメージ サービスを最適化するプロセスもサポートしています。

Type:Int32
Aliases:ImageIndex
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

OS イメージの名前を指定します。 最大長は 50 文字です。

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

OS イメージ WIM ファイルへのネットワーク パスを指定します。 パスには、拡張子を持つ WIM ファイル名を含める必要 .wim があります。

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

オプションのバージョンの OS イメージを指定します。 この値は、OS のバージョンではなく、内部バージョン管理用です。 最大長は 32 文字です。

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

入力

なし

出力

IResultObject

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_ImagePackage WMI クラス」を参照してください