次の方法で共有

Add-AzVMDataDisk

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

仮想マシンにデータ ディスクを追加します。

構文

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Add-AzVMDataDisk コマンドレットは、仮想マシンにデータ ディスクを追加します。 仮想マシンの作成時にデータ ディスクを追加することも、既存の仮想マシンにデータ ディスクを追加することもできます。

例

例 1: 新しい仮想マシンにデータ ディスクを追加する

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

最初のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 次の 3 つのコマンドは、$DataDiskVhdUri 01、$DataDiskVhdUri 02、および $DataDiskVhdUri 03 変数に 3 つのデータ ディスクのパスを割り当てます。 この方法は、次のコマンドの読みやすさのみを目的としています。 最後の 3 つのコマンドはそれぞれ、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 このコマンドは、ディスクの名前と場所、およびディスクのその他のプロパティを指定します。 各ディスクの URI は、$DataDiskVhdUri 01、$DataDiskVhdUri 02、および $DataDiskVhdUri 03 に格納されます。

例 2: 既存の仮想マシンにデータ ディスクを追加する

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

最初のコマンドは、Get-AzVM コマンドレットを使用して、VirtualMachine07 という名前の仮想マシンを取得します。 このコマンドは、仮想マシンを $VirtualMachine 変数に格納します。 2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 最後のコマンドは、ResourceGroup11 の$VirtualMachineに格納されている仮想マシンの状態を更新します。

例 3: 一般化されたユーザー イメージから新しい仮想マシンにデータ ディスクを追加する

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

最初のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 次の 2 つのコマンドでは、データ イメージとデータ ディスクのパスをそれぞれ$DataImageUri変数と$DataDiskUri変数に割り当てます。 この方法は、次のコマンドの読みやすさを向上させるために使用されます。 最後のコマンドは、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 このコマンドは、ディスクの名前と場所、およびディスクのその他のプロパティを指定します。

例 4: 特殊化されたユーザー イメージから新しい仮想マシンにデータ ディスクを追加する

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

最初のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 次のコマンドでは、データ ディスクのパスを $DataDiskUri 変数に割り当てます。 この方法は、次のコマンドの読みやすさを向上させるために使用されます。 最後のコマンドは、$VirtualMachineに格納されている仮想マシンにデータ ディスクを追加します。 このコマンドは、ディスクの名前と場所、およびディスクのその他のプロパティを指定します。

パラメーター

-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:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DeleteOption

データ ディスク削除オプション。 VM の削除後にディスクに対して実行するアクションを指定します。 オプションは[デタッチ]、[削除]です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DiskEncryptionSetId

カスタマー マネージド ディスク暗号化セットのリソース ID を指定します。 これは、マネージド ディスクに対してのみ指定できます。

型:String
配置: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
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

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

型:String
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SourceImageUri

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

型:String
Aliases:SourceImage
配置:7
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SourceResourceId

ディスクの作成元となるスナップショットまたはディスク復元ポイントの ARM ID。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageAccountType

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

型:String
配置:9
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VhdUri

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

型:String
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VM

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

型:PSVirtualMachine
Aliases:VMProfile
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WriteAccelerator

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

PSVirtualMachine

String

CachingTypes

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

出力

PSVirtualMachine

PSVirtualMachineScaleSetVM