Edit-AzDataProtectionPolicyRetentionRuleClientObject

Edit-AzDataProtectionPolicyRetentionRuleClientObject
    -Policy <IBackupPolicy>
    -Name <RetentionRuleName>
    [-RemoveRule]
    [<CommonParameters>]

Edit-AzDataProtectionPolicyRetentionRuleClientObject
    -Policy <IBackupPolicy>
    -Name <RetentionRuleName>
    -IsDefault <Boolean>
    -LifeCycles <ISourceLifeCycle[]>
    [-OverwriteLifeCycle <Boolean>]
    [<CommonParameters>]

既存のバックアップ ポリシーに保持ルールを追加または削除します。

$pol = Get-AzDataProtectionPolicyTemplate
$lifecycle = New-AzDataProtectionRetentionLifeCycleClientObject -SourceDataStore OperationalStore -SourceRetentionDurationType Weeks -SourceRetentionDurationCount 5
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -LifeCycles $lifecycle -IsDefault $false

DatasourceType            ObjectType
--------------            ----------
{Microsoft.Compute/disks} BackupPolicy

最初のコマンドは、既定のポリシー テンプレートを取得します。 2 番目のコマンドは、週単位のライフサイクル オブジェクトを作成します。 3 番目のコマンドは、既定のポリシーに週単位の保持ルールを追加します。

Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -RemoveRule

DatasourceType            ObjectType
--------------            ----------
{Microsoft.Compute/disks} BackupPolicy

このコマンドは、特定のバックアップ ポリシーに存在する場合、週単位の保持ルールを削除します。

$pol = Get-AzDataProtectionPolicyTemplate -DatasourceType AzureBlob
$opLifecycle = New-AzDataProtectionRetentionLifeCycleClientObject -SourceDataStore OperationalStore -SourceRetentionDurationType Days -SourceRetentionDurationCount 30
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Default_OperationalStore -LifeCycles $opLifecycle -IsDefault $true

DatasourceType                                  ObjectType
--------------                                  ----------
{Microsoft.Storage/storageAccounts/blobServices} BackupPolicy

AzureBlob の場合、OperationalStore の保持ルールには Default_OperationalStore という名前を付ける必要があります。 規則が追加されます。ポリシー テンプレートの既存の Default (VaultStore) 保持ルールが保持されます。 OperationalStore ライフサイクルで -Name Default を渡すことは、検証によって拒否されます。

注: -OverwriteLifeCycle は非推奨となり、今後のリリースで削除される予定です。 -OverwriteLifeCycle $false設定すると、既存の保持ルールの更新がブロックされます。$trueまたは省略すると、既存のルールのライフサイクルが所定の位置に置き換えられます。このパラメーターを削除すると、既定の動作になります。

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

• "Default" 保持ルールは、ライフサイクルに関係なく削除できません。 -RemoveRule -Name Default 例外を投げる Removing Default Retention Rule is not allowed. Please try again with different rule name.
• -OverwriteLifeCycle は非推奨であり、今後のリリースで削除される予定です。 -OverwriteLifeCycle $false設定すると、既存の保持ルールの更新がブロックされます。$trueまたは省略すると、既存のルールのライフサイクルが所定の位置に置き換えられます。このパラメーターを削除すると、既定の動作になります。