Set-AzRecoveryServicesBackupProtectionPolicy

Módulo:

Az.RecoveryServices

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

Sintaxis

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

Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [-FixForInconsistentItems]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

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

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FixForInconsistentItems

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MoveToArchiveTier

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

Tipo:	Nullable<T>[Boolean]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	PolicyBase
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-RetentionPolicy

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

Tipo:	RetentionPolicyBase
Posición:	2
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SchedulePolicy

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

Tipo:	SchedulePolicyBase
Posición:	3
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SnapshotConsistencyType

Tipo de coherencia de instantáneas que se va a usar para la copia de seguridad. Si se establece en OnlyCrashConsistent, todos los elementos asociados tendrán instantánea coherente con bloqueos. Los valores posibles son OnlyCrashConsistent, Default

Tipo:	SnapshotConsistencyType
Valores aceptados:	Default, OnlyCrashConsistent
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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

Tipo:	Nullable<T>[Int32]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TierAfterDurationType

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

Tipo:	String
Valores aceptados:	Days, Months
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TieringMode

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

Tipo:	TieringMode
Valores aceptados:	TierRecommended, TierAllEligible
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Token

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VaultId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

PolicyBase

String

Salidas

JobBase

Vínculos relacionados

• Get-AzRecoveryServicesBackupProtectionPolicy
• Get-AzRecoveryServicesBackupRetentionPolicyObject
• New-AzRecoveryServicesBackupProtectionPolicy
• Remove-AzRecoveryServicesBackupProtectionPolicy