Add-AzureRmVMDataDisk

  • リファレンス
モジュール:
AzureRM.Compute

仮想マシンまたは 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 です。 この値を変更すると、仮想マシンが再起動します。 この設定は、ディスクの整合性とパフォーマンスに影響します。
Type:CachingTypes
Accepted values:None, ReadOnly, ReadWrite
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CreateOption

このコマンドレットで、プラットフォームまたはユーザー イメージから仮想マシンにディスクを作成するか、空のディスクを作成するか、既存のディスクを接続するかを指定します。 このパラメーターの有効値は、次のとおりです。

  • 添付。 特殊化されたディスクから仮想マシンを作成するには、このオプションを指定します。 このオプションを指定する場合は、SourceImageUri パラメーターを指定しないでください。 VhdUri は、仮想マシンにデータ ディスクとして接続する仮想ハード ディスク (VHD) の場所を Azure プラットフォームに伝えるために必要なすべてです。
  • 空白。 空のデータ ディスクを作成するには、これを指定します。
  • FromImage。 一般化されたイメージまたはディスクから仮想マシンを作成するには、このオプションを指定します。 このオプションを指定する場合は、データ ディスクとして接続する VHD の場所を Azure プラットフォームに伝えるために、SourceImageUri パラメーターも指定する必要があります。 VhdUri パラメーターは、仮想マシンで使用されるときにデータ ディスク VHD が格納される場所を識別する場所として使用されます。
Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskSizeInGB

仮想マシンに接続する空のディスクのサイズをギガバイト単位で指定します。

Type:Nullable<T>[Int32]
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Lun

データ ディスクの論理ユニット番号 (LUN) を指定します。

Type:Nullable<T>[Int32]
Position:5
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagedDiskId

マネージド ディスクの ID を指定します。

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

-Name

追加するデータ ディスクの名前を指定します。

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

-SourceImageUri

このコマンドレットがアタッチするディスクのソース URI を指定します。

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

-StorageAccountType

マネージド ディスクのストレージ アカウントの種類を指定します。

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

-VhdUri

プラットフォーム イメージまたはユーザー イメージを使用するときに作成する仮想ハード ディスク (VHD) ファイルの URI (Uniform Resource Identifier) を指定します。 このコマンドレットは、イメージ バイナリ ラージ オブジェクト (BLOB) をこの場所にコピーします。 これは、仮想マシンを起動する場所です。

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

-VirtualMachineScaleSetVM

データ ディスクを追加するローカル仮想マシン スケール セット VM オブジェクトを指定します。 Get-AzureRmVmssVM コマンドレットを使用して、仮想マシン スケール セット VM オブジェクトを取得できます。

Type:PSVirtualMachineScaleSetVM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VM

データ ディスクを追加するローカル仮想マシン オブジェクトを指定します。 Get-AzureRmVM コマンドレットを使用して、仮想マシン オブジェクトを取得できます。 New-AzureRmVMConfig コマンドレットを使用して、仮想マシン オブジェクトを作成できます。

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WriteAccelerator

マネージド データ ディスクで WriteAccelerator を有効または無効にするかどうかを指定します。

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

入力

PSVirtualMachine

PSVirtualMachineScaleSetVM

String

CachingTypes

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

出力

PSVirtualMachine

PSVirtualMachineScaleSetVM