Edit-AzDataProtectionPolicyRetentionRuleClientObject
Aggiunge o rimuove la regola di conservazione a un criterio di backup esistente. Per i criteri ibridi di AzureBlob, i cicli di vita di OperationalStore devono usare -Name Default_OperationalStore; -Name Valore predefinito è riservato per VaultStore. La combinazione di questi (o il collegamento di un ciclo di vita di OperationalStore a Settimanale/Mensile/Annuale) genererà un errore di convalida.
Sintassi
RemoveRetention (Impostazione predefinita)
Edit-AzDataProtectionPolicyRetentionRuleClientObject
-Policy <IBackupPolicy>
-Name <RetentionRuleName>
[-RemoveRule]
[<CommonParameters>]
AddRetention
Edit-AzDataProtectionPolicyRetentionRuleClientObject
-Policy <IBackupPolicy>
-Name <RetentionRuleName>
-IsDefault <Boolean>
-LifeCycles <ISourceLifeCycle[]>
[-OverwriteLifeCycle <Boolean>]
[<CommonParameters>]
Descrizione
Aggiunge o rimuove la regola di conservazione a un criterio di backup esistente. Per i criteri ibridi di AzureBlob, i cicli di vita di OperationalStore devono usare -Name Default_OperationalStore; -Name Valore predefinito è riservato per VaultStore. La combinazione di questi (o il collegamento di un ciclo di vita di OperationalStore a Settimanale/Mensile/Annuale) genererà un errore di convalida.
Esempio
Esempio 1: Aggiungere una regola di conservazione settimanale
$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
Il primo comando ottiene il modello di criteri predefinito. Il secondo comando crea un oggetto ciclo di vita settimanale. Il terzo comando aggiunge una regola di conservazione settimanale ai criteri predefiniti.
Esempio 2: Rimuovere la regola di conservazione settimanale
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -RemoveRule
DatasourceType ObjectType
-------------- ----------
{Microsoft.Compute/disks} BackupPolicy
Questo comando rimuove la regola di conservazione settimanale, se presente nei criteri di backup specificati.
Esempio 3: Aggiungere una regola di conservazione OperationalStore a un criterio 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
Per AzureBlob, le regole di conservazione operationalstore devono essere denominate Default_OperationalStore.
La regola viene aggiunta in modo aggiuntivo: la regola di conservazione esistente Default (VaultStore) nel modello di criteri viene mantenuta.
Il passaggio con un ciclo di -Name Default vita operationalStore viene rifiutato dalla convalida.
Nota: -OverwriteLifeCycle è deprecato e verrà rimosso in una versione futura.
L'impostazione -OverwriteLifeCycle $false blocca l'aggiornamento di una regola di conservazione esistente. Quando $true o viene omesso, i cicli di vita della regola esistente vengono sostituiti, ovvero il comportamento predefinito dopo la rimozione di questo parametro.
Parametri
-IsDefault
Specifica se la regola di conservazione è una regola di conservazione predefinita.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AddRetention
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LifeCycles
Cicli di vita associati alla regola di conservazione.
Proprietà dei parametri
| Tipo: | |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AddRetention
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Nome regola di conservazione. Nota: le regole di conservazione "Predefinite" non possono essere rimosse, indipendentemente dal ciclo di vita.
Proprietà dei parametri
| Tipo: | RetentionRuleName |
| Valore predefinito: | None |
| Valori accettati: | Default, Daily, Weekly, Monthly, Yearly, Default_OperationalStore |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OverwriteLifeCycle
[Deprecato] Opzionale; questo parametro verrà rimosso in una versione futura. L'impostazione di -OverwriteLifeCycle $false blocca l'aggiornamento di una regola di conservazione esistente; quando $true o omesso, i cicli di vita delle regole esistenti vengono sostituiti sul posto, ovvero il comportamento predefinito dopo la rimozione di questo parametro.
Proprietà dei parametri
| Tipo: | |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AddRetention
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Policy
Oggetto Criteri di backup
Proprietà dei parametri
| Tipo: | IBackupPolicy |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RemoveRule
Specifica se rimuovere la regola di conservazione.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RemoveRetention
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
