Azure StorSimple 関連の PowerShell コマンドレット (Remove-AzureStorSimpleDeviceVolume) について

スポンサーリンク

StorSimple は、Microsoft 社が提供するハイブリッドのクラウド ストレージ サービスです。 Microsoft Azure と組み合わせることで、Azure ストレージを拡張領域として利用することが可能であり、また別拠点でのデータ復旧が可能であることから、効率的なデータ管理、災害対策が実現できます。

Azure StorSimple デバイスの管理に使用することが可能な PowerShell コマンドレットが提供されており、設定方法について MSDN サイト上で公開されていますが、PowerShell コマンドレットのヘルプについては英語のみであり、日本語による情報はほとんど公開されていません。

Azure StorSimple 関連の PowerShell コマンドレットの 1 つである「Remove-AzureStorSimpleDeviceVolume」について、本ブログにて日本語の情報として纏めてみました((他の PowerShell コマンドレットについては、「Azure StorSimple 関連の PowerShell コマンドレットについて」を参照) (Windows Azure PowerShell バージョン 0.9.7 で確認しているものとなります)。

■名前

Remove-AzureStorSimpleDeviceVolume

■概要

StorSimple デバイスからボリュームを削除します。

■構文

Remove-AzureStorSimpleDeviceVolume [-DeviceName] <String> [-VolumeName] <String> [[-WaitForComplete]] [[-Force]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

Remove-AzureStorSimpleDeviceVolume [-DeviceName] <String> [-Volume] <VirtualDisk> [[-WaitForComplete]] [[-Force]] [-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]] [<CommonParameters>]

■説明

Remove-AzureStorSimpleDeviceVolume コマンドレットは、StorSimple デバイスからボリュームを削除します。このコマンドレットは、-Force パラメータを指定がない場合、確認のプロンプトを表示します。

■パラメーター

-DeviceName <String>
削除する存在するボリューム上の StorSimple デバイス名を指定します。

必須true
位置1
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Force [<SwitchParameter>]
このコマンドレットで確認のプロンプトを表示しないかどうかを示します。

必須false
位置4
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]
Azure プロファイルを指定します。

必須false
位置named
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Volume <VirtualDisk>
VirtualDisk
オブジェクトとして、削除するボリュームを指定します。VirtualDisk オブジェクトを取得するために、Get-AzureStorSimpleDeviceVolume コマンドレットを使用します。

必須true
位置2
既定値なし
パイプライン入力を許可するtrue(ByValue)
ワイルドカード文字を許可するfalse

-VolumeName <String>
削除するボリューム名を指定します。

必須true
位置2
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-WaitForComplete [<SwitchParameter>]
Windows PowerShell コンソールに制御を返す前に、このコマンドレットが完了するための操作に対して待機するかを示します。

必須false
位置3
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: –Verbose、-Debug、-ErrorAction-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。

■入力

  • VirtualDisk
    このコマンドレットは、削除する VirtualDisk オブジェクト、もしくは削除する VirtualDisk のボリューム名を受け入れます。

■出力

  • TaskStatusInfo
    -WaitForComplete
    パラメーターを指定する場合、TaskStatusInfo オブジェクトを返します。

■メモ

  • 詳細については、「Get-Help Remove-AzureStorSimpleDeviceVolume -detailed」と入力してください。
  • 技術情報については、「Get-Help Remove-AzureStorSimpleDeviceVolume -full」と入力してください。

■エイリアス

  • なし

■例

例 1: パイプラインを用いたボリュームの削除

 Get-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" | Remove-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" 
VERBOSE: ClientRequestId: 2933e24d-9564-42b5-9053-5f0bc4f59ea8_PS
VERBOSE: ClientRequestId: 7c2d854b-537a-4253-bb0c-c15bc8aa2b49_PS
VERBOSE: ClientRequestId: 4bf749ac-517c-49e7-8027-a8f62e272014_PS
VERBOSE: ClientRequestId: 7d9ec87a-616d-4ca9-bfb8-158859174d59_PS

Confirm
Are you sure you want to remove the volume?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is “Y”): Y
VERBOSE: ClientRequestId: 67a38e28-a015-44b1-8159-c1a6604f4d81_PS
VERBOSE: About to run a job to remove your volume!
VERBOSE: ClientRequestId: 56101c10-07ca-40f4-8f19-c6fdd895e3a5_PS
32925451-4451-4478-89f7-d8930505d3fb
VERBOSE: The delete task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
32925451-4451-4478-89f7-d8930505d3fb for tracking the task’s status
VERBOSE: Volume with name: Volume18 is found.

このコマンドは、デバイス名「Contoso63-AppVm」上のボリューム名「Volume18」を取得し、パイプライン操作によって現在のコマンドレットにボリュームを渡します。現在のコマンドレットはボリューム削除のタスクを開始し、TaskResponse オブジェクトを返します。タスクの状態を確認するには、Get-AzureStorSimpleTask を使用します。コマンドが -Force パラメーターを指定しない場合、コマンドレットは確認のプロンプトを表示します。

例 2: 確認なしでのボリュームの削除

 Remove-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Force 

VERBOSE: ClientRequestId: 72f13290-41eb-4ac4-9535-da1a42d0fa0b_PS
VERBOSE: ClientRequestId: ae0c1d99-1a66-4a69-9260-f2c8c12546bd_PS
VERBOSE: ClientRequestId: 9610744f-d031-488f-87e6-3ecddb305e13_PS
VERBOSE: About to run a job to remove your volume!
VERBOSE: ClientRequestId: d33525d8-7276-4d2a-942d-d10f8078f1f7_PS
483f8cb4-ebc3-46a9-a9e6-0989e25738a0
VERBOSE: The delete task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
483f8cb4-ebc3-46a9-a9e6-0989e25738a0 for tracking the task’s status

このコマンドは、デバイス名「Contoso63-AppVm」からボリューム名「Volume18」を削除します。コマンドが -Force パラメータを指定すると、コマンドレットは確認のプロンプトを表示しません。

■関連するトピック

  • Get-AzureStorSimpleDeviceVolume
  • New-AzureStorSimpleDeviceVolume
  • Set-AzureStorSimpleDeviceVolume
  • Get-AzureStorSimpleJob

[参考]