Add-AzureRmVMDataDisk
仮想マシンまたは Vmss VM にデータ ディスクを追加します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Add-AzureRmVMDataDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-Lun] <Int32>
[-CreateOption] <String>
[[-SourceImageUri] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmVMDataDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-Lun] <Int32>
[-CreateOption] <String>
[[-ManagedDiskId] <String>]
[[-StorageAccountType] <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmVMDataDisk
[-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-Lun] <Int32>
[-CreateOption] <String>
[-ManagedDiskId] <String>
[[-StorageAccountType] <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzureRmVMDataDisk コマンドレットは、仮想マシンまたは Vmss VM にデータ ディスクを追加します。 データ ディスクは仮想マシンを作成するときに追加できます。または、既存のバーチャル マシンにデータ ディスクを追加できます。
例
例 1: 新しい仮想マシンにデータ ディスクを追加する
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
PS C:\> $DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
PS C:\> $DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty
最初のコマンドは、仮想マシン オブジェクトを作成し、それを $VirtualMachine 変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 次の 3 つのコマンドは、3 つのデータ ディスクのパスを、$DataDiskVhdUri01 変数、$DataDiskVhdUri02 変数、および $DataDiskVhdUri03 変数に割り当てます。 この方法は、次のコマンドの読みやすさのみを目的としています。 最後の 3 つのコマンドはそれぞれ、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 このコマンドは、ディスクの名前と場所、およびディスクのその他のプロパティを指定します。 各ディスクの URI は、$DataDiskVhdUri01$DataDiskVhdUri02、および $DataDiskVhdUri03 に格納されます。
例 2: 既存の仮想マシンにデータ ディスクを追加する
PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzureRmVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine
最初のコマンドは、Get-AzureRmVM コマンドレットを使用して VirtualMachine07 という名前の仮想マシンを取得します。 コマンドは仮想マシンを変数 $VirtualMachine に保存します。 2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 最後のコマンドは、ResourceGroup11 の$VirtualMachineに格納されている仮想マシンの状態を更新します。
例 3: 一般化されたユーザー イメージから新しい仮想マシンにデータ ディスクを追加する
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage
最初のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 次の 2 つのコマンドでは、データ イメージとデータ ディスクのパスをそれぞれ$DataImageUri変数と$DataDiskUri変数に割り当てます。 この方法は、次のコマンドの読みやすさを向上させるために使用されます。 最後のコマンドは、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 このコマンドは、ディスクの名前と場所、およびディスクのその他のプロパティを指定します。
例 4: 特殊化されたユーザー イメージから新しい仮想マシンにデータ ディスクを追加する
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach
最初のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 次のコマンドでは、データ ディスクのパスを $DataDiskUri 変数に割り当てます。 この方法は、次のコマンドの読みやすさを向上させるために使用されます。 最後のコマンドは、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 このコマンドは、ディスクの名前と場所、およびディスクのその他のプロパティを指定します。
例 5: Vmss VM にマネージド データ ディスクを追加する。
PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVMDataDisk -VirtualMachineScaleSetVM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> Update-AzureRmVmssVM -VirtualMachineScaleSetVM $VmssVM
最初のコマンドは、既存のマネージド ディスクを取得します。 次のコマンドは、リソース グループ名、vmss 名、およびインスタンス ID によって指定された既存の Vmss VM を取得します。 次のコマンドは、$VmssVMにローカルに格納されている Vmss VM にマネージド ディスクを追加します。 最後のコマンドは、追加されたデータ ディスクを使用して Vmss VM を更新します。
パラメーター
-Caching
ディスクのキャッシュ モードを指定します。 このパラメーターの有効値は、次のとおりです。
- ReadOnly
- ReadWrite
- なし 既定値は ReadWrite です。 この値を変更すると、仮想マシンが再起動します。 この設定は、ディスクの整合性とパフォーマンスに影響します。
型: | CachingTypes |
指定可能な値: | None, ReadOnly, ReadWrite |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-CreateOption
このコマンドレットで、プラットフォームまたはユーザー イメージから仮想マシンにディスクを作成するか、空のディスクを作成するか、既存のディスクを接続するかを指定します。 このパラメーターの有効値は、次のとおりです。
- 添付。 特殊化されたディスクから仮想マシンを作成するには、このオプションを指定します。 このオプションを指定する場合は、SourceImageUri パラメーターを指定しないでください。 VhdUri は、仮想マシンにデータ ディスクとして接続する仮想ハード ディスク (VHD) の場所を Azure プラットフォームに伝えるために必要なすべてです。
- 空白。 空のデータ ディスクを作成するには、これを指定します。
- FromImage。 一般化されたイメージまたはディスクから仮想マシンを作成するには、このオプションを指定します。 このオプションを指定する場合は、データ ディスクとして接続する VHD の場所を Azure プラットフォームに伝えるために、SourceImageUri パラメーターも指定する必要があります。 VhdUri パラメーターは、仮想マシンで使用されるときにデータ ディスク VHD が格納される場所を識別する場所として使用されます。
型: | String |
配置: | 6 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DiskSizeInGB
仮想マシンに接続する空のディスクのサイズをギガバイト単位で指定します。
型: | Nullable<T>[Int32] |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Lun
データ ディスクの論理ユニット番号 (LUN) を指定します。
型: | Nullable<T>[Int32] |
配置: | 5 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ManagedDiskId
マネージド ディスクの ID を指定します。
型: | String |
配置: | 8 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
追加するデータ ディスクの名前を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SourceImageUri
このコマンドレットがアタッチするディスクのソース URI を指定します。
型: | String |
Aliases: | SourceImage |
配置: | 7 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StorageAccountType
マネージド ディスクのストレージ アカウントの種類を指定します。
型: | String |
配置: | 9 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VhdUri
プラットフォーム イメージまたはユーザー イメージを使用するときに作成する仮想ハード ディスク (VHD) ファイルの URI (Uniform Resource Identifier) を指定します。 このコマンドレットは、イメージ バイナリ ラージ オブジェクト (BLOB) をこの場所にコピーします。 これは、仮想マシンを起動する場所です。
型: | String |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VirtualMachineScaleSetVM
データ ディスクを追加するローカル仮想マシン スケール セット VM オブジェクトを指定します。 Get-AzureRmVmssVM コマンドレットを使用して、仮想マシン スケール セット VM オブジェクトを取得できます。
型: | PSVirtualMachineScaleSetVM |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VM
データ ディスクを追加するローカル仮想マシン オブジェクトを指定します。 Get-AzureRmVM コマンドレットを使用して、仮想マシン オブジェクトを取得できます。 New-AzureRmVMConfig コマンドレットを使用して、仮想マシン オブジェクトを作成できます。
型: | PSVirtualMachine |
Aliases: | VMProfile |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WriteAccelerator
マネージド データ ディスクで WriteAccelerator を有効または無効にするかどうかを指定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]