Azure Backup に関する Azure リソース マネージャーでの PowerShell コマンドレット (Remove-AzureRMBackupVault) について

スポンサーリンク

2015/09/10 (現地時間) にプレビュー版で提供されていた Azure VM に対するバックアップ (Azure VM Backup) が (GA) となり、正式リリースされました。

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

Azure Backup に関する Azure リソース マネージャー PowerShell コマンドレットの 1 つである「Remove-AzureRMBackupVault」について、本ブログにて日本語の情報として纏めてみました ((他の PowerShell コマンドレットについては、「Azure Backup に関する Azure リソース マネージャーでの PowerShell コマンドレットについて」を参照) (Windows Azure PowerShell バージョン 0.9.8 で確認しているものとなります) (Azure リソース マネージャー モードに変更して実行する必要があります)。

■名前

Remove-AzureRMBackupVault

■概要

指定したパラメーターに基づく Azure Backup 資格情報コンテナーオブジェクトを削除します。

■構文

Remove-AzureRMBackupVault [-Vault] <AzureRMBackupVault> [-Profile <AzureProfile>] [<CommonParameters>]

■説明

コマンドレットは、バックアップ 資格情報コンテナーを削除します。しかし、資格情報コンテナーを削除する前に、バックアップ データ、もしくは保護された項目、もしくは登録済みのサーバーが含まれない、空の状態にする必要があります。これは資格情報コンテナーを誤って削除することができないことを保証します。バックアップ 資格情報コンテナーの削除は、計画的な操作です。

資格情報コンテナーから IaaS 仮想マシン バックアップ データを削除するために Remove-AzureBackupContainer コマンドレットを使用する、もしくは他の登録済みのサーバーおよびバックアップ データを削除するために Delete-RegisteredServer コマンドレットを使用します。

■パラメーター

-Vault <AzureRMBackupVault>
削除する Azure Backup 資格情報コンテナーオブジェクトを指定します。資格情報コンテナーを取得するために、Get-AzureRMBackupVault コマンドレットを用います。

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

-Profile <AzureProfile>
AzureProfile 入力オブジェクトは必須ではありません。

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

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

■入力

  • AzureRMBackupVault

■出力

  • なし

■メモ

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

■エイリアス

  • なし

■例

例 1: Azure Backup 資格情報コンテナーの削除

 Get-AzureBackupVault -Name "myvault" | Remove-AzureBackupVault

■関連するトピック

  • RemoveAzureRMBackupContainer
  • New-AzureRMBackupVault
  • Get-AzureRMBackupVault
  • Set-AzureRMBackupVault

[参考]