次の方法で共有

New-AzRecoveryServicesBackupProtectionPolicy

  • リファレンス
モジュール:
Az.RecoveryServices

バックアップ保護ポリシーを作成します。

構文

New-AzRecoveryServicesBackupProtectionPolicy
   [-Name] <String>
   [-WorkloadType] <WorkloadType>
   [[-BackupManagementType] <BackupManagementType>]
   [[-RetentionPolicy] <RetentionPolicyBase>]
   [[-SchedulePolicy] <SchedulePolicyBase>]
   [[-MoveToArchiveTier] <Boolean>]
   [[-TieringMode] <TieringMode>]
   [[-TierAfterDuration] <Int32>]
   [[-TierAfterDurationType] <String>]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzRecoveryServicesBackupProtectionPolicy コマンドレットは、コンテナーにバックアップ保護ポリシーを作成します。 保護ポリシーは、少なくとも 1 つのアイテム保持ポリシーに関連付けられています。 保持ポリシーでは、Azure Backup で復旧ポイントを保持する期間を定義します。 Get-AzRecoveryServicesBackupRetentionPolicyObject コマンドレットを使用して、既定のアイテム保持ポリシーを取得できます。 また、Get-AzRecoveryServicesBackupSchedulePolicyObject コマンドレットを使用して、既定のスケジュール ポリシーを取得できます。 SchedulePolicy オブジェクトと RetentionPolicy オブジェクトは、New-AzRecoveryServicesBackupProtectionPolicy コマンドレットへの入力として使用されます。 現在のコマンドレットを使用する前に、Set-AzRecoveryServicesVaultContext コマンドレットを使用してコンテナー コンテキストを設定します。

例

例 1: バックアップ保護ポリシーを作成する

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM"
$SchPol.ScheduleRunTimes.Clear()
$Dt = Get-Date
$SchPol.ScheduleRunTimes.Add($Dt.ToUniversalTime())
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM"
$RetPol.DailySchedule.DurationCountInDays = 365
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $RetPol -SchedulePolicy $SchPol

最初のコマンドは、SchedulePolicyObject基本を取得し、それを $SchPol 変数に格納します。 2 番目のコマンドは、スケジュールされた実行時間をすべて、$SchPolのスケジュール ポリシーから削除します。 3 番目のコマンドでは、Get-Date コマンドレットを使用して現在の日付と時刻を取得します。 4 番目のコマンドは、スケジュールされた実行時間として$Dtの現在の日付と時刻をスケジュール ポリシーに追加します。 5 番目のコマンドは、RetentionPolicy オブジェクト 基本を取得し、それを$RetPol変数に格納します。 6 番目のコマンドは、保持期間ポリシーを 365 日に設定します。 最後のコマンドは、前のコマンドによって作成されたスケジュールポリシーと保持ポリシーに基づいて、BackupProtectionPolicy オブジェクトを作成します。

例 2: 1 日に複数のバックアップのファイル共有ポリシーを作成する

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$timeZone = Get-TimeZone
$schedulePolicy.ScheduleRunTimeZone = $timeZone.Id
$startTime = Get-Date -Date "2021-12-22T06:00:00.00+00:00"
$schedulePolicy.ScheduleWindowStartTime = $startTime.ToUniversalTime()
$schedulePolicy.ScheduleInterval = 6
$schedulePolicy.ScheduleWindowDuration = 14
$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy.DailySchedule.DurationCountInDays = 10
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy

最初のコマンドは、SchedulePolicyObject基本時間単位を取得し、それを $schedulePolicy 変数に格納します。 2 番目と 3 番目のコマンドは、タイムゾーンをフェッチし、$schedulePolicyのタイムゾーンを更新します。 4 番目と 5 番目のコマンドは、スケジュール ウィンドウの開始時刻を初期化し、$schedulePolicyを更新します。 タイムゾーンが UTC でない場合でも、開始時刻は UTC である必要があることに注意してください。 6 番目と 7 番目のコマンドは、スケジュールが実行される同じ日の期間 (時間単位) にバックアップが再トリガーされる間隔 (時間単位) を更新します。 8 番目のコマンドは、RetentionPolicy オブジェクト 基本時間単位を取得し、$retentionPolicy変数に格納します。 9 番目のコマンドは、保持期間ポリシーを 10 日に設定します。 最後のコマンドは、前のコマンドによって作成されたスケジュールポリシーと保持ポリシーに基づいて、BackupProtectionPolicy オブジェクトを作成します。

例 3

バックアップ保護ポリシーを作成します。 (自動生成)

New-AzRecoveryServicesBackupProtectionPolicy -Name 'NewPolicy' -RetentionPolicy $RetPol -SchedulePolicy $SchPol -VaultId $vault.ID -WorkloadType AzureVM

例 4: TieringMode TierRecommended を使用してアーカイブ スマート階層化を有効にする新しい AzureVM ポリシーを作成する

$pol = New-AzRecoveryServicesBackupProtectionPolicy -Name newTierRecommendedPolicy -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultId $vault.ID -MoveToArchiveTier $true -TieringMode TierRecommended

このコマンドは、階層化モード TierRecommended のアーカイブ スマート階層化を有効にするポリシーを作成するために使用されます。-MoveToArchiveTier パラメーターを $true に設定してスマート階層化を有効にします。 TieringMode を TierRecommended に設定して、推奨されるすべての復旧ポイントをアーカイブに移動します。 階層化モード TierRecommended は、ワークロードの種類が AzureVM でのみサポートされることに注意してください。

例 5: アーカイブ スマート階層化を無効にして新しいポリシーを作成する

$pol = New-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID  -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -MoveToArchiveTier $false

このコマンドは、ポリシーの作成時にアーカイブ スマート階層化を無効にするために使用されます。MoveToArchiveTier パラメーターを $false に設定して階層化を無効にします。

例 6: workloadType MSSQL の UTC 以外のタイムゾーン標準ポリシーを作成する

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload -PolicySubType Standard

$timeZone = Get-TimeZone -ListAvailable | Where-Object { $_.Id -match "Tokyo" } 
$date= Get-Date -Hour 9 -Minute 0 -Second 0 -Year 2022 -Day 26 -Month 12 -Millisecond 0
$date = [DateTime]::SpecifyKind($date,[DateTimeKind]::Utc)
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunFrequency = "Weekly"
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimes[0] = $date
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimeZone = $timeZone[0].Id

$schedulePolicy.IsDifferentialBackupEnabled = $true
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunDays[0] = "Wednesday"
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunTimes[0] = $date.AddHours(1)

$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload

$retentionPolicy.DifferentialBackupRetentionPolicy.RetentionCount = 15

$retentionPolicy.FullBackupRetentionPolicy.IsDailyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.IsMonthlyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.WeeklySchedule.DurationCountInWeeks = 35
$retentionPolicy.FullBackupRetentionPolicy.YearlySchedule.DurationCountInYears = 2

New-AzRecoveryServicesBackupProtectionPolicy -Name "Tokyo-mssql-policy" -WorkloadType MSSQL -BackupManagementType AzureWorkload -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy -VaultId $vault.ID

最初のコマンドは、SchedulePolicyObjectを取得し、それを $schedulePolicy 変数に格納します。 2 番目のコマンド ブロックは、タイムゾーンと datetime (UTC としてマークされたローカル時刻) をフェッチし、$schedulePolicyのタイムゾーンと時刻を更新します。 タイムゾーンは個別に指定されるため、datetime は常に UTC としてマークする必要があることに注意してください。 また、他のワークロードの種類のタイムゾーンについては、$schedulePolicy.ScheduleRunTimeZone 属性で指定する必要があります。 3 番目のコマンド ブロックは、差分スケジュール ポリシーを更新します。 次に、RetentionPolicyObject を取得し、差分および完全バックアップの保持設定を更新します。 最後に、前のコマンドで作成したスケジュールと保持ポリシーに基づいて、BackupProtectionPolicy オブジェクトを作成します。

パラメーター

-BackupManagementType

保護されているリソースのクラス。 このパラメーターに使用できる値は次のとおりです。

  • AzureVM
  • AzureStorage
  • AzureWorkload
型:Nullable<T>[BackupManagementType]
指定可能な値:AzureVM, AzureStorage, AzureWorkload
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-BackupSnapshotResourceGroup

マネージド仮想マシンのインスタント 復旧ポイントを格納するためのカスタム リソース グループ名。 これは省略可能です

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BackupSnapshotResourceGroupSuffix

マネージド仮想マシンのインスタント 復旧ポイントを格納するためのカスタム リソース グループ名サフィックス。 これは省略可能です

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MoveToArchiveTier

復旧ポイントをポリシーによってアーカイブ ストレージに移動するかどうかを指定します。 使用できる値は$true、$false

型:Nullable<T>[Boolean]
配置:6
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

ポリシーの名前を指定します。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RetentionPolicy

RetentionPolicy オブジェクト 基本を指定します。 Get-AzRecoveryServicesBackupRetentionPolicyObject コマンドレットを使用して、RetentionPolicy オブジェクトを取得できます。

型:RetentionPolicyBase
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SchedulePolicy

SchedulePolicy オブジェクト 基本を指定します。 Get-AzRecoveryServicesBackupSchedulePolicyObject コマンドレットを使用して、SchedulePolicy オブジェクトを取得できます。

型:SchedulePolicyBase
配置:5
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SnapshotConsistencyType

バックアップに使用するスナップショット整合性の種類。 OnlyCrashConsistent に設定すると、関連付けられているすべての項目にクラッシュ整合性スナップショットが設定されます。 使用可能な値は OnlyCrashConsistent、既定値です

型:SnapshotConsistencyType
指定可能な値:Default, OnlyCrashConsistent
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TierAfterDuration

復旧ポイントがアーカイブ層への移行を開始する期間を指定します。値は日数または月単位で指定できます。 TieringMode が TierAllEligible の場合にのみ適用されます

型:Nullable<T>[Int32]
配置:8
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TierAfterDurationType

TierAfterDuration を日数または月単位で指定します。

型:String
指定可能な値:Days, Months
配置:9
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TieringMode

推奨またはすべての対象復旧ポイントをアーカイブに移動するかどうかを指定します。

型:TieringMode
指定可能な値:TierRecommended, TierAllEligible
配置:7
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VaultId

Recovery Services コンテナーの ARM ID。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WorkloadType

リソースのワークロードの種類。 このパラメーターに使用できる値は次のとおりです。

  • AzureVM
  • AzureFiles
  • MSSQL
型:WorkloadType
指定可能な値:AzureVM, AzureFiles, MSSQL
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

WorkloadType

Nullable<T>[[Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.BackupManagementType, Microsoft.Azure.PowerShell.Cmdlets.RecoveryServices.Backup.Models, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

RetentionPolicyBase

SchedulePolicyBase

String

出力

PolicyBase