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

スポンサーリンク

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

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

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

■名前

Backup-AzureRMBackupItem

■概要

保護された項目に対するバックアップを実行します。

■構文

Backup-AzureRMBackupItem [-Item] <AzureRMBackupItem> [-Profile <AzureProfile>] [<CommonParameters>]

■説明

このコマンドレットを使用することは、「今すぐバックアップ」に相当します。これは、バックアップ スケジュールに縛られていないアドホック バックアップを実行します。これは 2 つのシナリオで有用です:

  1. 保護を有効にした後、すぐに最初のバックアップを開始
  2. 以前スケジュールされたバックアップが失敗した時のアドホック バックアップを実行

■パラメーター

-Item <AzureRMBackupItem>
アドホック バックアップを実行する Azure Backup 項目を指定します。

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

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

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

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

■入力

  • AzureRMBackupItem

■出力

  • AzureRMBackupJob

■メモ

  • 既存のバックアップ ジョブが実行中の場合、このコマンドレットは失敗します。

■備考

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

■エイリアス

  • なし

■例

例 1: 仮想マシンに対するバックアップの実行

 Get-AzureRMBackupItem -Container $c | Backup-AzureRMBackupItem 
WorkloadName    Operation       Status          StartTime              EndTime
————    ———       ——          ———              ——-
test-vm         Backup          InProgress      26-Aug-15 12:24:01 PM  01-Jan-01 12:00:00 AM

例 2: 既存のバックアップが実行している場合、バックアップ実行失敗

 Get-AzureRMBackupItem -Container $c | Backup-AzureRMBackupItem 

WorkloadName    Operation       Status          StartTime              EndTime
————    ———       ——          ———              ——-
test-vm         Backup          Failed          26-Aug-15 12:30:30 PM  26-Aug-15 12:30:30 PM

■関連するリンク

  • なし

[参考]