Edit-AzDataProtectionPolicyRetentionRuleClientObject
Dodaje lub usuwa regułę przechowywania do istniejących zasad tworzenia kopii zapasowych. W przypadku zasad hybrydowych usługi AzureBlob cykle życia operationalStore muszą używać -Name Default_OperationalStore; -Name Wartość domyślna jest zarezerwowana dla magazynu VaultStore. Połączenie tych (lub dołączenie cyklu życia operationalStore do cotygodniowego/miesięcznego/co roku) spowoduje wyświetlenie błędu weryfikacji.
Składnia
RemoveRetention (domyślnie)
Edit-AzDataProtectionPolicyRetentionRuleClientObject
-Policy <IBackupPolicy>
-Name <RetentionRuleName>
[-RemoveRule]
[<CommonParameters>]
AddRetention
Edit-AzDataProtectionPolicyRetentionRuleClientObject
-Policy <IBackupPolicy>
-Name <RetentionRuleName>
-IsDefault <Boolean>
-LifeCycles <ISourceLifeCycle[]>
[-OverwriteLifeCycle <Boolean>]
[<CommonParameters>]
Opis
Dodaje lub usuwa regułę przechowywania do istniejących zasad tworzenia kopii zapasowych. W przypadku zasad hybrydowych usługi AzureBlob cykle życia operationalStore muszą używać -Name Default_OperationalStore; -Name Wartość domyślna jest zarezerwowana dla magazynu VaultStore. Połączenie tych (lub dołączenie cyklu życia operationalStore do cotygodniowego/miesięcznego/co roku) spowoduje wyświetlenie błędu weryfikacji.
Przykłady
Przykład 1. Dodawanie reguły przechowywania tygodniowego
$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
Pierwsze polecenie pobiera domyślny szablon zasad. Drugie polecenie tworzy obiekt cyklu życia tygodniowego. Trzecie polecenie dodaje regułę przechowywania tygodniowego do domyślnych zasad.
Przykład 2. Usuwanie reguły przechowywania tygodniowego
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -RemoveRule
DatasourceType ObjectType
-------------- ----------
{Microsoft.Compute/disks} BackupPolicy
To polecenie usuwa regułę przechowywania tygodniowego, jeśli istnieje w podanych zasadach tworzenia kopii zapasowych.
Przykład 3. Dodawanie reguły przechowywania operationalStore do zasad 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
W przypadku usługi AzureBlob reguły przechowywania magazynu operationalstore muszą mieć nazwę Default_OperationalStore.
Reguła jest dodawana dodatkowo — istniejąca Default reguła przechowywania magazynu (VaultStore) w szablonie zasad jest zachowywana.
Przekazywanie -Name Default z cyklem życia operationalStore jest odrzucane przez walidację.
Uwaga: -OverwriteLifeCycle jest przestarzała i zostanie usunięta w nadchodzącej wersji.
Ustawienie -OverwriteLifeCycle $false bloków aktualizacji istniejącej reguły przechowywania; jeśli $true lub pominięto, cykle życia istniejącej reguły są zastępowane — domyślne zachowanie po usunięciu tego parametru.
Parametry
-IsDefault
Określa, czy reguła przechowywania jest domyślną regułą przechowywania.
Właściwości parametru
| Typ: | Boolean |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
AddRetention
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-LifeCycles
Cykle życia skojarzone z regułą przechowywania.
Właściwości parametru
| Typ: | |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
AddRetention
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Nazwa reguły przechowywania. Uwaga: Nie można usunąć domyślnych reguł przechowywania niezależnie od cyklu życia.
Właściwości parametru
| Typ: | RetentionRuleName |
| Domyślna wartość: | None |
| Dopuszczalne wartości: | Default, Daily, Weekly, Monthly, Yearly, Default_OperationalStore |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-OverwriteLifeCycle
[Przestarzałe] Opcjonalne; ten parametr zostanie usunięty w nadchodzącej wersji. Ustawienie -OverwriteLifeCycle $false blokuje aktualizowanie istniejącej reguły przechowywania; w przypadku $true lub pominięcia istniejące cykle życia reguły są zastępowane — zachowanie domyślne po usunięciu tego parametru.
Właściwości parametru
| Typ: | |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
AddRetention
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Policy
Obiekt zasad kopii zapasowej
Właściwości parametru
| Typ: | IBackupPolicy |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-RemoveRule
Określa, czy usunąć regułę przechowywania.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
RemoveRetention
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
