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

スポンサーリンク

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

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

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

■名前

New-AzureRMBackupProtectionPolicy

■概要

バックアップ ポリシー情報を保持している PowerShell オブジェクトを作成します。

■構文

New-AzureRMBackupProtectionPolicy [-Name] <String> [-Type] <String> [-BackupTime] <DateTime> [[-DaysOfWeek] <String[]>] [-RetentionPolicy] <AzureRMBackupRetentionPolicy[]> [-Vault] <AzureRMBackupVault> [-Profile <AzureProfile>] [<CommonParameters>]

New-AzureRMBackupProtectionPolicy [-Name] <String> [-Type] <String> [[-Daily] [<SwitchParameter>]] [-BackupTime] <DateTime> [-RetentionPolicy] <AzureRMBackupRetentionPolicy[]> [-Vault] <AzureRMBackupVault> [-Profile <AzureProfile>] [<CommonParameters>]

New-AzureRMBackupProtectionPolicy [-Name] <String> [-Type] <String> [-Weekly] [<SwitchParameter>] [-BackupTime] <DateTime> [[-DaysOfWeek] <String[]>] [-RetentionPolicy] <AzureRMBackupRetentionPolicy[]> [-Vault] <AzureRMBackupVault> [-Profile <AzureProfile>] [<CommonParameters>]

■説明

バックアップ ポリシーは、いつ項目のバックアップがいつ行われれるか、およびその頻度を定義します。このコマンドレットは、バックアップ ポリシー情報を保持する PowerShell オブジェクトを作成します。バックアップ ポリシーは Enable-AzureRMBackupProtection コマンドレットへ入力として使用されます。

Daily、Weekly、Monthly、および Yearly の 4 種類の保持があります。使用する予定がある保持データの種類ごとに 1 つのオブジェクトを作成する必要があります。

■パラメーター

-Name <String>
バックアップ ポリシー名を指定します。資格情報コンテナー内で一意である必要があります。

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

-Type <String>
ポリシーが適用されるバックアップ項目の型を指定します。現在サポートされている値は AzureVM のみです。

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

-BackupTime <DateTime>
バックアップが起動する必要がある場合の時間を指定します。

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

-DaysOfWeek <String[]>
バックアップが -BackupTime オプションを使用して指定された時間に起動された場合、1 つ以上の曜日を指定します。このパラメーターは、-Weekly フラグと一緒に使用する必要があります。

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

-RetentionPolicy <AzureRMBackupRetentionPolicy[]>
このバックアップ ポリシー内に関連付けられた 1 つ以上の保持ポリシーを指定します。保持ポリシーを作成するために New-AzureRMBackupRetentionPolicyObject オブジェクトを用います。

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

-Vault <AzureRMBackupVault>
バックアップポリシーに対して親である Azure Backup 資格情報コンテナーを指定します。

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

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

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

-Daily [<SwitchParameter>]
バックアップ ポリシーが毎日実行されることを示すフラグです。

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

-Weekly [<SwitchParameter>]
バックアップ ポリシーが週 1 日以上で実行されることを示すフラグです。

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

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

■入力

  • なし

■出力

  • AzureRMBackupProtectionPolicy

■メモ

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

■エイリアス

  • なし

■例

例 1: 日次、月次保持する 日次バックアップ ポリシーの作成

 $bp = New-AzureRMBackupProtectionPolicy -Name DailyBackup01 -Type AzureVM -Daily -BackupTime ([datetime]"3:30 PM") -RetentionPolicy ($Daily,$Monthly) -Vault $v 

Name                      Type               ScheduleType       BackupTime
—-                      —-               ————       ———-
DailyBkp                  AzureVM            Daily              26-Aug-15 3:00:00 PM

この例のバックアップ ポリシーは、3:00 PM に日次バックアップ、New-AzureRMBackupRetentionPolicyObject コマンドレットを用いて作成された $Daily および $Monthly 保持ポリシーとして格納されたバックアップ データを持ちます。

■関連するトピック

  • New-AzureRMBackupRetentionPolicyObject
  • Enable-AzureRMBackupProtection
  • Get-AzureRMBackupProtectionPolicy
  • Set-AzureRMBackupProtectionPolicy
  • Remove-AzureRMBackupProtectionPolicy

[参考]