Save-AzureRmVMImage
仮想マシンを VMImage として保存します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Save-AzureRmVMImage
[-Name] <String>
[-DestinationContainerName] <String>
[-VHDNamePrefix] <String>
[-Overwrite]
[[-Path] <String>]
[-ResourceGroupName] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Save-AzureRmVMImage
[-Name] <String>
[-DestinationContainerName] <String>
[-VHDNamePrefix] <String>
[-Overwrite]
[[-Path] <String>]
[-Id] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Save-AzureRmVMImage コマンドレットは、仮想マシンを VMImage として保存します。 仮想マシン イメージを作成する前に、仮想マシンを sysprep し、Set-AzureRmVM コマンドレットを使用して一般化済みとしてマークします。 このコマンドレットの出力は、JavaScript Object Notation (JSON) テンプレートです。 キャプチャしたイメージから仮想マシンをデプロイできます。
例
例 1: 仮想マシンをキャプチャする
PS C:\> Set-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized
PS C:\> Save-AzureRmVMImage -ResourceGroupName "ResourceGroup11" -VMName "VirtualMachine07" -DestinationContainerName "VMContainer01" -VHDNamePrefix "VM07"
最初のコマンドは、VirtualMachine07 という名前の仮想マシンを一般化済みとしてマークします。 2 番目のコマンドは、VirtualMachine07 という名前の仮想マシンを VMImage としてキャプチャします。 Output プロパティは JSON テンプレートを返します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行し、進行状況を追跡するジョブを返します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DestinationContainerName
イメージを保持する "システム" コンテナー内のコンテナーの名前を指定します。 コンテナーが存在しない場合、コンテナーは自動的に作成されます。 VMImage を構成する仮想ハード ディスク (VHD) は、このパラメーターが指定するコンテナーに存在します。 VHD が複数のストレージ アカウントに分散されている場合、このコマンドレットは、各ストレージ アカウントにこの名前を持つ 1 つのコンテナーを作成します。 保存されたイメージの URL は、https://< storageAccountName.blob.core.windows.net/system/Microsoft.Compute/Images/>< imagesContainer>/<vhdPrefix-osDisk.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.vhd> のようになります。
型: | String |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Id
仮想マシンのリソース ID を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
名前を指定します。
型: | String |
Aliases: | VMName |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Overwrite
このコマンドレットは、宛先コンテナー内で同じプレフィックスを持つ VHD を上書きすることを示します。
型: | SwitchParameter |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Path
キャプチャされたイメージのテンプレートが格納されるファイル パス。
型: | String |
配置: | 5 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
仮想マシンのリソース グループの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VHDNamePrefix
VMImage のストレージ プロファイルを構成する BLOB の名前にプレフィックスを指定します。 たとえば、オペレーティング システム ディスクのプレフィックス vhdPrefix は、vhdPrefix-osdisk という名前になります。<guid.vhd>。
型: | String |
Aliases: | VirtualHardDiskNamePrefix |
配置: | 3 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |