Set-AzRecoveryServicesBackupProtectionPolicy

  • Referencia
Módulo:
Az.RecoveryServices

Modifica una directiva de protección de copia de seguridad.

Syntax

Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [[-RetentionPolicy] <RetentionPolicyBase>]
   [[-SchedulePolicy] <SchedulePolicyBase>]
   [-MoveToArchiveTier <Boolean>]
   [-TieringMode <TieringMode>]
   [-TierAfterDuration <Int32>]
   [-TierAfterDurationType <String>]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-Token <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [-FixForInconsistentItems]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzRecoveryServicesBackupProtectionPolicy modifica una directiva de protección de Azure Backup existente. Puede modificar los componentes de la directiva de retención y programación de copia de seguridad. Los cambios realizados afectan a la copia de seguridad y retención de los elementos asociados a la directiva. Establezca el contexto del almacén mediante el cmdlet Set-AzRecoveryServicesVaultContext antes de usar el cmdlet actual.

Ejemplos

Ejemplo 1: Modificar una directiva de protección de copia de seguridad

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM" 
$SchPol.ScheduleRunTimes.Clear()
$Time = Get-Date
$Time1 = Get-Date -Year $Time.Year -Month $Time.Month -Day $Time.Day -Hour $Time.Hour -Minute 0 -Second 0 -Millisecond 0
$Time1 = $Time1.ToUniversalTime()
$SchPol.ScheduleRunTimes.Add($Time1)
$SchPol.ScheduleRunFrequency.Clear
$SchPol.ScheduleRunDays.Add("Monday")
$SchPol.ScheduleRunFrequency="Weekly"
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM" 
$RetPol.IsDailyScheduleEnabled=$false
$RetPol.DailySchedule.DurationCountInDays = 0
$RetPol.IsWeeklyScheduleEnabled=$true 
$RetPol.WeeklySchedule.DaysOfTheWeek.Add("Monday")
$RetPol.WeeklySchedule.DurationCountInWeeks = 365
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "azurefiles" -Name "azurefilesvault"
$Pol= Get-AzRecoveryServicesBackupProtectionPolicy -Name "TestPolicy" -VaultId $vault.ID
$Pol.SnapshotRetentionInDays=5
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $Pol -SchedulePolicy $SchPol -RetentionPolicy $RetPol -BackupSnapshotResourceGroup "snapshotResourceGroupPrefix" -BackupSnapshotResourceGroupSuffix "snapshotResourceGroupSuffix"

Esta es la descripción general de los pasos que se deben seguir para modificar una directiva de protección:

  1. Obtenga una clase SchedulePolicyObject base y RetentionPolicyObject base. Almacénelos en alguna variable.
  2. Establezca los distintos parámetros del objeto de directiva de programación y retención según sus necesidades. Por ejemplo: en el script de ejemplo anterior, estamos intentando establecer una directiva de protección semanal. Por lo tanto, cambiamos la frecuencia de programación a "Semanal" y también actualizamos el tiempo de ejecución de la programación. En el objeto de directiva de retención, actualizamos la duración semanal de la retención y establecemos la marca correcta "programación semanal habilitada". En caso de que desee establecer una directiva diaria, establezca la marca "programación diaria habilitada" en true y asigne los valores adecuados para otros parámetros de objeto.
  3. Obtenga la directiva de protección de copia de seguridad que desea modificar y almacenarla en una variable. En el ejemplo anterior, recuperamos la directiva de copia de seguridad con el nombre "TestPolicy" que queríamos modificar.
  4. Modifique la directiva de protección de copia de seguridad recuperada en el paso 3 mediante el objeto de directiva de programación modificado y el objeto de directiva de retención. Usamos el parámetro BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix para actualizar el nombre del grupo de recursos de instantánea para los RP instantáneos.

Ejemplo 2: Modificación de la directiva de recursos compartidos de archivos de Azure para varias copias de seguridad al día

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$timeZone = Get-TimeZone
$schedulePolicy.ScheduleRunTimeZone = $timeZone.Id
$startTime = Get-Date -Date "2021-12-22T06:00:00.00+00:00"
$schedulePolicy.ScheduleWindowStartTime = $startTime.ToUniversalTime()
$schedulePolicy.ScheduleInterval = 6
$schedulePolicy.ScheduleWindowDuration = 14
$retentionPolicy.DailySchedule.DurationCountInDays = 6
$policy = Get-AzRecoveryServicesBackupProtectionPolicy -Name "TestPolicy" -VaultId $vault.ID
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $policy -VaultId $vault.ID -SchedulePolicy $schedulePolicy -RetentionPolicy $retentionPolicy

Esta es la descripción general de los pasos que se deben seguir para modificar una directiva de recurso compartido de archivos para varias copias de seguridad al día:

  1. Obtenga una clase SchedulePolicyObject base por hora y RetentionPolicyObject base por hora. Almacénelos en alguna variable.
  2. Establezca los distintos parámetros del objeto de directiva de programación y retención según sus necesidades. Por ejemplo: en el script de ejemplo anterior, estamos intentando establecer el $timeZone en el que queremos ejecutar la programación que estamos estableciendo la hora de inicio de la programación por hora, estableciendo el intervalo por hora (en horas), después del cual se volverá a intentar la copia de seguridad en el mismo día, duración (en horas) para la que se ejecutará la programación. A continuación, vamos a modificar la configuración de retención para los puntos de recuperación diarios.
  3. Obtenga la directiva de protección de copia de seguridad que desea modificar y almacenarla en una variable. En el ejemplo anterior, recuperamos la directiva de copia de seguridad con el nombre "TestPolicy" que queríamos modificar.
  4. Modifique la directiva de protección de copia de seguridad recuperada en el paso 3 mediante el objeto de directiva de programación modificado y el objeto de directiva de retención.

Ejemplo 3: Modificación de la directiva de AzureWorkload para habilitar el almacenamiento en capas inteligentes de archivo

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $true -TieringMode TierAllEligible -TierAfterDuration 60 -TierAfterDurationType Days

Este comando se usa para modificar la directiva para habilitar el almacenamiento en capas inteligentes de archivo para la directiva $policy, se establece el parámetro -MoveToArchiveTier en $true para habilitar la organización por niveles. Elegimos TieringMode para que sea TierAllEligible para mover todos los puntos de recuperación aptos al archivo después de una duración determinada por los parámetros TierAfterDuration y TierAfterDurationType. Para mover los puntos de recuperación recomendados a Archive para AzureVM, use TieringMode TierRecommended.

Ejemplo 4: Deshabilitar la organización por niveles inteligentes en una directiva existente

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $false

Este comando se usa para deshabilitar los niveles inteligentes de archivo para la directiva $policy, establecemos el parámetro -MoveToArchiveTier en $false. Tenga en cuenta que deshabilitar los niveles inteligentes de archivo podría tener implicaciones de costo.

Parámetros

-BackupSnapshotResourceGroup

Nombre del grupo de recursos personalizado para almacenar los puntos de recuperación instantáneos de las máquinas virtuales administradas. Esto es opcional

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackupSnapshotResourceGroupSuffix

Sufijo de nombre de grupo de recursos personalizado para almacenar los puntos de recuperación instantáneos de las máquinas virtuales administradas. Esto es opcional

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FixForInconsistentItems

Modificador Parámetro que indica si se va a reintentar o no la actualización de directiva para los elementos con errores.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MoveToArchiveTier

Especifica si la directiva debe mover los puntos de recuperación al almacenamiento de archivo. Los valores permitidos son $true, $false

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Policy

Especifica la directiva de protección de copia de seguridad que modifica este cmdlet. Para obtener un objeto BackupProtectionPolicy , use el cmdlet Get-AzRecoveryServicesBackupProtectionPolicy.

Type:PolicyBase
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RetentionPolicy

Especifica la directiva de retención base. Para obtener un objeto RetentionPolicy , use el cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject.

Type:RetentionPolicyBase
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SchedulePolicy

Especifica el objeto de directiva de programación base. Para obtener un objeto SchedulePolicy , use el objeto Get-AzRecoveryServicesBackupSchedulePolicyObject.

Type:SchedulePolicyBase
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDuration

Especifica la duración después de la cual los puntos de recuperación deben empezar a pasar al nivel de archivo, el valor puede estar en días o meses. Solo se aplica cuando TieringMode es TierAllEligible

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDurationType

Especifica si tierAfterDuration está en días o meses.

Type:String
Accepted values:Days, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TieringMode

Especifica si se deben mover los puntos de recuperación recomendados o todos los puntos de recuperación aptos al archivo.

Type:TieringMode
Accepted values:TierRecommended, TierAllEligible
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Token

Token de acceso auxiliar para autenticar la operación crítica en la suscripción de Protección de recursos

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

Id. de ARM del almacén de Recovery Services.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PolicyBase

String

Salidas

JobBase