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

最初のコマンドは、基本の 1 時間ごとの 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

Type:	Nullable<T>[BackupManagementType]
Accepted values:	AzureVM, AzureStorage, AzureWorkload
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-BackupSnapshotResourceGroup

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupSnapshotResourceGroupSuffix

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MoveToArchiveTier

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

Type:	Nullable<T>[Boolean]
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RetentionPolicy

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

Type:	RetentionPolicyBase
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SchedulePolicy

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

Type:	SchedulePolicyBase
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SnapshotConsistencyType

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

Type:	SnapshotConsistencyType
Accepted values:	Default, OnlyCrashConsistent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TierAfterDuration

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

Type:	Nullable<T>[Int32]
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TierAfterDurationType

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

Type:	String
Accepted values:	Days, Months
Position:	9
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TieringMode

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

Type:	TieringMode
Accepted values:	TierRecommended, TierAllEligible
Position:	7
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VaultId

Recovery Services コンテナーの ARM ID。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkloadType

リソースのワークロードの種類。このパラメーターの有効値は、次のとおりです。

AzureVM
AzureFiles
MSSQL

Type:	WorkloadType
Accepted values:	AzureVM, AzureFiles, MSSQL
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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

New-AzRecoveryServicesBackupProtectionPolicy

構文

説明

例

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

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

例 3

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

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

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

パラメーター

-BackupManagementType

-BackupSnapshotResourceGroup

-BackupSnapshotResourceGroupSuffix

-Confirm

-DefaultProfile

-MoveToArchiveTier

-Name

-RetentionPolicy

-SchedulePolicy

-SnapshotConsistencyType

-TierAfterDuration

-TierAfterDurationType

-TieringMode

-VaultId

-WhatIf

-WorkloadType

入力

出力

フィードバック

その他のリソース

New-AzRecoveryServicesBackupProtectionPolicy

構文

説明

例

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

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

例 3

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

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

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

パラメーター

-BackupManagementType

-BackupSnapshotResourceGroup

-BackupSnapshotResourceGroupSuffix

-Confirm

-DefaultProfile

-MoveToArchiveTier

-Name

-RetentionPolicy

-SchedulePolicy

-SnapshotConsistencyType

-TierAfterDuration

-TierAfterDurationType

-TieringMode

-VaultId

-WhatIf

-WorkloadType

入力

出力

関連リンク

フィードバック

その他のリソース

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

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