Remove-AzureRmVMDataDisk

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

仮想マシンからデータ ディスクを削除します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Remove-AzureRmVMDataDisk
      [-VM] <PSVirtualMachine>
      [[-DataDiskNames] <String[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-AzureRmVMDataDisk コマンドレットは、仮想マシンからデータ ディスクを削除します。

例

例 1: 仮想マシンからデータ ディスクを削除する

PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" 
PS C:\> Remove-AzureRmVMDataDisk -VM $VirtualMachine -Name "Disk3"
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

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

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DataDiskNames

このコマンドレットによって削除される 1 つ以上のデータ ディスクの名前を指定します。

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

-DefaultProfile

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

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

-VM

データ ディスクの削除元となるローカル仮想マシン オブジェクトを指定します。 仮想マシン オブジェクトを取得するには、Get-AzureRmVM コマンドレットを使用します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

PSVirtualMachine

出力

PSVirtualMachine