Share via

Remove-AzureDataDisk

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

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

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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 ストレージから削除することを示します。

Type:SwitchParameter
Position:1
Default value:None
Required:False
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 です。

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
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