Edit-AzDataProtectionPolicyRetentionRuleClientObject

Modul:

Az.DataProtection Module

Menambahkan atau menghapus Aturan Penyimpanan ke kebijakan pencadangan yang ada.

Sintaks

RemoveRetention (Default)

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

AddRetention

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

Deskripsi

Menambahkan atau menghapus Aturan Penyimpanan ke kebijakan pencadangan yang ada.

Contoh

Contoh 1: Tambahkan Aturan Retensi Mingguan

$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

Perintah pertama mendapatkan templat kebijakan default. Perintah kedua membuat objek siklus hidup mingguan. Perintah ketiga menambahkan aturan retensi mingguan ke kebijakan default.

Contoh 2: Hapus Aturan Retensi Mingguan

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

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

Perintah ini menghapus aturan retensi mingguan jika ada dalam kebijakan pencadangan yang diberikan.

Contoh 3: Menambahkan aturan retensi OperationalStore ke kebijakan AzureBlob

$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

Untuk AzureBlob, aturan retensi OperationalStore harus diberi nama Default_OperationalStore. Aturan ditambahkan secara aditif — aturan retensi (VaultStore) yang ada Default pada templat kebijakan dipertahankan. -Name Default Melewati siklus hidup OperationalStore ditolak oleh validasi.

Catatan: -OverwriteLifeCycle tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Mengatur -OverwriteLifeCycle $false blok yang memperbarui aturan retensi yang ada; saat $true atau dihilangkan, siklus hidup aturan yang ada diganti — perilaku default setelah parameter ini dihapus.

Parameter

-IsDefault

Menentukan apakah aturan retensi adalah aturan retensi default.

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

AddRetention

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-LifeCycles

Siklus hidup yang terkait dengan aturan retensi.

Properti parameter

Jenis:	ISourceLifeCycle[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

AddRetention

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Name

Nama Aturan Retensi. Catatan: "Default" aturan retensi tidak dapat dihapus, terlepas dari siklus hidupnya.

Properti parameter

Jenis:	RetentionRuleName
Nilai default:	None
Nilai yang diterima:	Default, Daily, Weekly, Monthly, Yearly, Default_OperationalStore
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-OverwriteLifeCycle

[Tidak digunakan lagi] Opsional; parameter ini akan dihapus dalam rilis mendatang. Mengatur -OverwriteLifeCycle $false blok yang memperbarui aturan retensi yang ada; saat $true atau dihilangkan, siklus hidup aturan yang ada diganti — perilaku default setelah parameter ini dihapus.

Properti parameter

Jenis:	Nullable<T>[Boolean]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

AddRetention

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Policy

Objek Kebijakan Pencadangan

Properti parameter

Jenis:	IBackupPolicy
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-RemoveRule

Menentukan apakah akan menghapus aturan retensi.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

RemoveRetention

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Output

IBackupPolicy

Catatan

• "Default" aturan retensi tidak dapat dihapus, terlepas dari siklus hidup. -RemoveRule -Name Default Melempar Removing Default Retention Rule is not allowed. Please try again with different rule name.
• -OverwriteLifeCycle tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Mengatur -OverwriteLifeCycle $false blok yang memperbarui aturan retensi yang ada; saat $true atau dihilangkan, siklus hidup aturan yang ada diganti — perilaku default setelah parameter ini dihapus.