Remove-AzureDataDisk
Azure 仮想マシンからデータ ディスクを削除します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Remove-AzureDataDisk
[-LUN] <Int32>
[-DeleteVHD]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
説明
Remove-AzureDataDisk コマンドレットは、Azure 仮想マシンからデータ ディスクを削除します。 既定では、このコマンドレットはストレージ アカウントからデータ ディスク BLOB を削除しません。
例
例 1: データ ディスクを削除する
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Remove-AzureDataDisk -LUN 0
このコマンドは、Get-AzureVM コマンドレットを使用して、ContosoService という名前のサービス内の VirtualMachine07 という名前の仮想マシンを取得します。 このコマンドは、パイプライン 演算子を使用して、仮想マシンを現在のコマンドレットに渡します。 現在のコマンドレットは、LUN 0 を持つデータ ディスクを削除します。
例 2: データ ディスクと仮想ハード ディスク ファイルを削除する
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Remove-AzureDataDisk -LUN 0 -DeleteVHD | Update-AzureVM
このコマンドは、ContosoService という名前のサービス内の VirtualMachine07 という名前の仮想マシンを取得します。 このコマンドは、仮想マシンを現在のコマンドレットに渡します。 現在のコマンドレットは、LUN 0 を持つデータ ディスクを削除します。 このコマンドには、DeleteVHD パラメーターが含まれています。 したがって、基になる仮想ハード ディスクも削除されます。 このコマンドは、Update-AzureVM コマンドレットを使用して、変更を反映するように仮想マシンを更新します。
パラメーター
-DeleteVHD
このコマンドレットは、データ ディスクと仮想ハード ディスク (VHD) を BLOB ストレージから削除することを示します。
型: | SwitchParameter |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
型: | ActionPreference |
Aliases: | infa |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
型: | String |
Aliases: | iv |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LUN
仮想マシン内のデータ ドライブの論理ユニット番号 (LUN) を指定します。 有効な値は 0 から 15 です。
型: | Int32 |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VM
データ ディスクに接続されている仮想マシン オブジェクトを指定します。 仮想マシン オブジェクトを取得するには、Get-AzureVM コマンドレットを使用します。
型: | IPersistentVM |
Aliases: | InputObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |