New-CMOperatingSystemImage

  • リファレンス
モジュール:
ConfigurationManager

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

構文

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

説明

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

注:

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

例

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

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

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

パラメーター

-Confirm

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

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

-Description

イメージの識別に役立つ省略可能な説明を指定します。 最大長は 127 文字です。

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

-ForceWildcardHandling

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

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

-Index

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

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

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

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

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

-Version

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

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

入力

None

出力

IResultObject

メモ

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