Edit-AzDataProtectionPolicyRetentionRuleClientObject

Modulo:
Az.DataProtection Module

Aggiunge o rimuove la regola di conservazione a un criterio di backup esistente.

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.

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 sul posto, 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:

ISourceLifeCycle[]

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: "Default" le regole di conservazione 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 -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 sul posto, ovvero il comportamento predefinito dopo la rimozione di questo parametro.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

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.

Output

IBackupPolicy

Note

  • "Default" le regole di conservazione non possono essere rimosse, indipendentemente dal ciclo di vita. -RemoveRule -Name Default Genera Removing Default Retention Rule is not allowed. Please try again with different rule name.
  • -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 sul posto, ovvero il comportamento predefinito dopo la rimozione di questo parametro.