New-CMOperatingSystemImage
OS イメージを作成します。
構文
New-CMOperatingSystemImage
[-Description <String>]
-Name <String>
-Path <String>
[-Index <Int32>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、Configuration Manager サイトに OS イメージを追加します。 OS イメージは、参照ファイルとフォルダーの圧縮されたコレクションを表す WIM ファイルです。 Configuration Manager では、これらのイメージをタスク シーケンスと共に使用して、コンピューターに OS を展開します。 詳細については、「 Configuration Manager を使用して OS イメージを管理する」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: OS イメージを作成する
このコマンドは、OS イメージのインストール ソース ファイルへのネットワーク パスから "Windows 10 latest" という名前の OS イメージを作成します。
New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Description
イメージの識別に役立つ省略可能な説明を指定します。 最大長は 127 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Index
このパラメーターを追加すると、サイトはマルチインデックス イメージから 1 つのインデックス イメージを抽出します。 次に、元のイメージと同じソース フォルダーに新しいイメージを配置します。
このオプションを使用すると、イメージ ファイルが小さくなり、オフライン サービスが高速になります。 また、ソフトウェア更新プログラムを適用した後に 、より小さなイメージ ファイルに対してイメージ サービスを最適化するプロセスもサポートします。
型: | Int32 |
Aliases: | ImageIndex |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
OS イメージの名前を指定します。 最大長は 50 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
OS イメージ WIM ファイルへのネットワーク パスを指定します。 パスには、 .wim
拡張子を持つ WIM ファイル名を含める必要があります。
型: | String |
Aliases: | PackageSourcePath |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Version
OS イメージの省略可能なバージョンを指定します。 この値は、OS のバージョンではなく、内部バージョン管理用です。 最大長は 32 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_ImagePackage」を参照してください。