Add-AzureDataDisk
データ ディスクを仮想マシンに追加します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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
このコマンドレットによってデータ ディスクが作成されることを示します。
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskLabel
新しいデータ ディスクのディスク ラベルを指定します。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskName
ディスク リポジトリ内のデータ ディスクの名前を指定します。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskSizeInGB
新しいデータ ディスクの論理ディスク サイズをギガバイト単位で指定します。
Type: | Int32 |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostCaching
ディスクのホスト レベルのキャッシュ設定を指定します。 有効な値は次のとおりです。
- なし
- ReadOnly
- ReadWrite
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Import
このコマンドレットがイメージ リポジトリから既存のデータ ディスクをインポートすることを示します。
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImportFrom
このコマンドレットは、ストレージ アカウント内の BLOB から既存のデータ ディスクをインポートすることを示します。
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
情報変数を指定します。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LUN
仮想マシン内のデータ ドライブの論理ユニット番号 (LUN) を指定します。 有効な値は 0 から 15 です。 各データ ディスクには一意の LUN が必要です。
Type: | Int32 |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaLocation
このコマンドレットがデータ ディスクを格納する Azure ストレージ アカウント内の BLOB の場所を指定します。 場所を指定しない場合、コマンドレットは、現在のサブスクリプションの既定のストレージ アカウントの vhds コンテナーにデータ ディスクを格納します。 vhds コンテナーが存在しない場合、コマンドレットは vhds コンテナーを作成します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
このコマンドレットがデータ ディスクを接続する仮想マシン オブジェクトを指定します。 仮想マシン オブジェクトを取得するには、Get-AzureVM コマンドレットを使用します。
Type: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |