Add-AzureDataDisk

  • リファレンス
モジュール:
Azure

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

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

Add-AzureDataDisk
   [-CreateNew]
   [-DiskSizeInGB] <Int32>
   [-DiskLabel] <String>
   [-LUN] <Int32>
   [-MediaLocation <String>]
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-Import]
   [-DiskName] <String>
   [-LUN] <Int32>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-ImportFrom]
   [-DiskLabel] <String>
   [-LUN] <Int32>
   -MediaLocation <String>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

説明

Add-AzureDataDisk コマンドレットは、新規または既存のデータ ディスクを Azure 仮想マシン オブジェクトに追加します。 CreateNew パラメーターを使用して、指定したサイズとラベルを持つ新しいデータ ディスクを作成します。 Import パラメーターを使用して、イメージ リポジトリから既存のディスクをアタッチします。 ImportFrom パラメーターを使用して、ストレージ アカウント内の BLOB から既存のディスクをアタッチします。 接続されているデータ ディスクのホスト キャッシュ モードを指定できます。

例

例 1: リポジトリからデータ ディスクをインポートする

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

このコマンドは、Get-AzureVM コマンドレットを使用して、ContosoService クラウド サービスの VirtualMachine07 という名前の仮想マシンの仮想マシン オブジェクトを取得します。 このコマンドは、パイプライン演算子を使用して現在のコマンドレットに渡します。 このコマンドにより、リポジトリから仮想マシンに既存のデータ ディスクがアタッチされます。 データ ディスクの LUN は 0 です。 このコマンドは、Update-AzureVM コマンドレットを使用して、変更を反映するように仮想マシンを更新します。

例 2: 新しいデータ ディスクを追加する

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

このコマンドは、VirtualMachine08 という名前の仮想マシンの仮想マシン オブジェクトを取得します。 このコマンドは、現在のコマンドレットに渡します。 このコマンドにより、MyNewDisk.vhd という名前の新しいデータ ディスクがアタッチされます。 このコマンドレットは、現在のサブスクリプションの既定のストレージ アカウントの vhds コンテナーにディスクを作成します。 このコマンドは、変更を反映するように仮想マシンを更新します。

例 3: 指定した場所からデータ ディスクを追加する

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

このコマンドは、Database という名前の仮想マシンの仮想マシン オブジェクトを取得します。 このコマンドは、現在のコマンドレットに渡します。 このコマンドにより、指定した場所から Disk14.vhd という名前の既存のデータ ディスクがアタッチされます。 このコマンドは、変更を反映するように仮想マシンを更新します。

パラメーター

-CreateNew

このコマンドレットによってデータ ディスクが作成されることを示します。

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

-DiskLabel

新しいデータ ディスクのディスク ラベルを指定します。

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

-DiskName

ディスク リポジトリ内のデータ ディスクの名前を指定します。

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

-DiskSizeInGB

新しいデータ ディスクの論理ディスク サイズをギガバイト単位で指定します。

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

-HostCaching

ディスクのホスト レベルのキャッシュ設定を指定します。 有効な値は次の通りです。

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

-Import

このコマンドレットがイメージ リポジトリから既存のデータ ディスクをインポートすることを示します。

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

-ImportFrom

このコマンドレットは、ストレージ アカウント内の BLOB から既存のデータ ディスクをインポートすることを示します。

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

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • [中断]
型:ActionPreference
Aliases:infa
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InformationVariable

情報変数を指定します。

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

-LUN

仮想マシン内のデータ ドライブの論理ユニット番号 (LUN) を指定します。 有効な値は 0 から 15 です。 各データ ディスクには一意の LUN が必要です。

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

-MediaLocation

このコマンドレットがデータ ディスクを格納する Azure ストレージ アカウント内の BLOB の場所を指定します。 場所を指定しない場合、コマンドレットは、現在のサブスクリプションの既定のストレージ アカウントの vhds コンテナーにデータ ディスクを格納します。 vhds コンテナーが存在しない場合、コマンドレットは vhds コンテナーを作成します。

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

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

-VM

このコマンドレットがデータ ディスクを接続する仮想マシン オブジェクトを指定します。 仮想マシン オブジェクトを取得するには、Get-AzureVM コマンドレットを使用します。

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