Compartir a través de

New-AzRecoveryServicesBackupProtectionPolicy

  • Referencia
Módulo:
Az.RecoveryServices

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

Sintaxis

New-AzRecoveryServicesBackupProtectionPolicy
   [-Name] <String>
   [-WorkloadType] <WorkloadType>
   [[-BackupManagementType] <BackupManagementType>]
   [[-RetentionPolicy] <RetentionPolicyBase>]
   [[-SchedulePolicy] <SchedulePolicyBase>]
   [[-MoveToArchiveTier] <Boolean>]
   [[-TieringMode] <TieringMode>]
   [[-TierAfterDuration] <Int32>]
   [[-TierAfterDurationType] <String>]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzRecoveryServicesBackupProtectionPolicy crea una directiva de protección de copia de seguridad en un almacén. Una directiva de protección está asociada con al menos una directiva de retención. La directiva de retención define el tiempo que los puntos de recuperación se conservan en Azure Backup. Puede usar el cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject para obtener la directiva de retención predeterminada. Y puede usar el cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject para obtener la directiva de programación predeterminada. Los objetos SchedulePolicy y RetentionPolicy se usan como entradas para el cmdlet New-AzRecoveryServicesBackupProtectionPolicy . Establezca el contexto del almacén mediante el cmdlet Set-AzRecoveryServicesVaultContext antes de usar el cmdlet actual.

Ejemplos

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

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM"
$SchPol.ScheduleRunTimes.Clear()
$Dt = Get-Date
$SchPol.ScheduleRunTimes.Add($Dt.ToUniversalTime())
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM"
$RetPol.DailySchedule.DurationCountInDays = 365
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $RetPol -SchedulePolicy $SchPol

El primer comando obtiene una clase SchedulePolicyObject base y, a continuación, la almacena en la variable $SchPol. El segundo comando quita todos los tiempos de ejecución programados de la directiva de programación en $SchPol. El tercer comando usa el cmdlet Get-Date para obtener la fecha y hora actuales. El cuarto comando agrega la fecha y hora actuales en $Dt como la hora de ejecución programada a la directiva de programación. El quinto comando obtiene un objeto RetentionPolicy base y, a continuación, lo almacena en la variable $RetPol. El sexto comando establece la directiva de duración de retención en 365 días. El comando final crea un objeto BackupProtectionPolicy basado en la programación y las directivas de retención creadas por los comandos anteriores.

Ejemplo 2: Crear una directiva de recurso compartido de archivos para varias copias de seguridad al día

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -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 = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy.DailySchedule.DurationCountInDays = 10
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy

El primer comando obtiene una schedulePolicyObject base cada hora y, a continuación, la almacena en la variable $schedulePolicy. El segundo y el tercer comando capturan la zona horaria y actualizan la zona horaria del $schedulePolicy. Los comandos cuarto y quinto inicializan la hora de inicio de la ventana de programación y actualizan $schedulePolicy. Tenga en cuenta que la hora de inicio debe estar en UTC aunque la zona horaria no sea UTC. Los comandos sexto y séptimo actualizan el intervalo (en horas) después del cual se volverá a desencadenar la copia de seguridad en el mismo día, con la duración (en horas) para la que se ejecutará la programación. El octavo comando obtiene un objeto RetentionPolicy por hora base y, a continuación, lo almacena en la variable $retentionPolicy. El noveno comando establece la directiva de duración de retención en 10 días. El comando final crea un objeto BackupProtectionPolicy basado en la programación y las directivas de retención creadas por los comandos anteriores.

Ejemplo 3

Crea una directiva de protección de copia de seguridad. (generado automáticamente)

New-AzRecoveryServicesBackupProtectionPolicy -Name 'NewPolicy' -RetentionPolicy $RetPol -SchedulePolicy $SchPol -VaultId $vault.ID -WorkloadType AzureVM

Ejemplo 4: Creación de una nueva directiva de AzureVM para habilitar el almacenamiento en capas inteligentes de archivo con TieringMode TierRecommended

$pol = New-AzRecoveryServicesBackupProtectionPolicy -Name newTierRecommendedPolicy -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultId $vault.ID -MoveToArchiveTier $true -TieringMode TierRecommended

Este comando se usa para crear una directiva para habilitar la organización en niveles inteligentes de archivo para el modo de niveles TierRecommended, establecemos el parámetro -MoveToArchiveTier en $true para habilitar la organización por niveles inteligentes. Establecemos TieringMode en TierRecommended para mover todos los puntos de recuperación recomendados al archivo. Tenga en cuenta que el modo de niveles TierRecommended solo se admite para el tipo de carga de trabajo AzureVM.

Ejemplo 5: Creación de una nueva directiva con niveles inteligentes de archivo deshabilitado

$pol = New-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID  -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -MoveToArchiveTier $false

Este comando se usa para deshabilitar los niveles inteligentes de archivo al crear una directiva, se establece el parámetro MoveToArchiveTier en $false para deshabilitar la organización por niveles.

Ejemplo 6: Creación de una directiva estándar de zona horaria no UTC para workloadType MSSQL

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload -PolicySubType Standard

$timeZone = Get-TimeZone -ListAvailable | Where-Object { $_.Id -match "Tokyo" } 
$date= Get-Date -Hour 9 -Minute 0 -Second 0 -Year 2022 -Day 26 -Month 12 -Millisecond 0
$date = [DateTime]::SpecifyKind($date,[DateTimeKind]::Utc)
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunFrequency = "Weekly"
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimes[0] = $date
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimeZone = $timeZone[0].Id

$schedulePolicy.IsDifferentialBackupEnabled = $true
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunDays[0] = "Wednesday"
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunTimes[0] = $date.AddHours(1)

$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload

$retentionPolicy.DifferentialBackupRetentionPolicy.RetentionCount = 15

$retentionPolicy.FullBackupRetentionPolicy.IsDailyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.IsMonthlyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.WeeklySchedule.DurationCountInWeeks = 35
$retentionPolicy.FullBackupRetentionPolicy.YearlySchedule.DurationCountInYears = 2

New-AzRecoveryServicesBackupProtectionPolicy -Name "Tokyo-mssql-policy" -WorkloadType MSSQL -BackupManagementType AzureWorkload -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy -VaultId $vault.ID

El primer comando obtiene un SchedulePolicyObject y, a continuación, lo almacena en la variable $schedulePolicy. El segundo bloque de comandos captura la zona horaria y la fecha y hora (hora local marcadas como UTC) y actualiza la zona horaria y la hora en el $schedulePolicy. Tenga en cuenta que la fecha y hora siempre debe marcarse como UTC, ya que la zona horaria se da por separado. Tenga en cuenta también que, para otros tipos de carga de trabajo, se debe proporcionar la zona horaria en el atributo $schedulePolicy.ScheduleRunTimeZone. El tercer bloque de comandos actualiza la directiva de programación diferencial. A continuación, obtenemos la configuración de retención diferencial y completa de retentionPolicyObject y actualizamos la configuración de retención de copia de seguridad completa. Por último, creamos un objeto BackupProtectionPolicy basado en la programación y las directivas de retención creadas por los comandos anteriores.

Parámetros

-BackupManagementType

La clase de recursos que se protege. Los valores permitidos para este parámetro son los siguientes:

  • AzureVM
  • AzureStorage
  • AzureWorkload
Tipo:Nullable<T>[BackupManagementType]
Valores aceptados:AzureVM, AzureStorage, AzureWorkload
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-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

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

-Name

Especifica el nombre de la directiva.

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

-RetentionPolicy

Especifica el objeto RetentionPolicy base. Puede usar el cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject para obtener un objeto RetentionPolicy .

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

-SchedulePolicy

Especifica el objeto SchedulePolicy base. Puede usar el cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject para obtener un objeto SchedulePolicy .

Tipo:SchedulePolicyBase
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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:8
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:9
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:7
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

-WorkloadType

Tipo de carga de trabajo del recurso. Los valores permitidos para este parámetro son los siguientes:

  • AzureVM
  • AzureFiles
  • MSSQL
Tipo:WorkloadType
Valores aceptados:AzureVM, AzureFiles, MSSQL
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

WorkloadType

Nullable<T>[[Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.BackupManagementType, Microsoft.Azure.PowerShell.Cmdlets.RecoveryServices.Backup.Models, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

RetentionPolicyBase

SchedulePolicyBase

String

Salidas

PolicyBase