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

スポンサーリンク

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

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

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

■名前

Register-AzureRMBackupContainer

■概要

資格情報コンテナーを持つコンテナーを登録します。

■構文

Register-AzureRMBackupContainer -Name <String> -ServiceName <String> [-Vault] <AzureRMBackupVault> [-Profile <AzureProfile>] [<CommonParameters>]

Register-AzureRMBackupContainer -Name <String> -ResourceGroupName <String> [-Vault] <AzureRMBackupVault> [-Profile <AzureProfile>] [<CommonParameters>]

■説明

Azure Backup でバックアップを構成するための第一歩として、Azure Backup 資格情報コンテナーを使用して、マシンもしくは仮想マシンを登録します。Register-AzureRMBackupContainer コマンドレットは、Azure IaaS 仮想マシンの情報を入力として、指定した資格情報コンテナーで登録します。登録操作は、バックアップ 資格情報コンテナーで Azure 仮想マシンと関連付け、バックアップ ライフサイクルを通して仮想マシンを追跡します。

■パラメーター

-Name <String>
登録する Azure 仮想マシン名を指定します。

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

-ServiceName <String>
Azure 仮想マシンが登録されるクラウド サービス名を指定します。通常、クラウド サービス名は「.cloudapp.net」サフィックスを持ちます。このコマンドレットに入力としてサフィックスを含めないでください! 仮想マシン情報を取得するために Get-AzureVM コマンドレット (AzureServiceManagement モード)を使用することが可能です。サービス名は、VM オブジェクト内の DeploymentName プロパティです。

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

-Vault <AzureRMBackupVault>
Azure 仮想マシンが登録される Azure Backup 資格情報コンテナーを指定します。

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

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

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

-ResourceGroupName <String>
仮想マシンが AzureResourceManager モードで作成されている場合、-ServiceName パラメーターの代わりに、このパラメーターを使用する必要があります。

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

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

■入力

  • AzureRMBackupVault

■出力

  • AzureRMBackupJob

■メモ

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

■エイリアス

  • なし

■例

例 1: AzureRMBackupJob

 $job = Register-AzureRMBackupContainer -Vault $v -Name "testvm" -ServiceName "testvm" 

■関連するトピック

  • Get-AzureVM

[参考]