New-AzRecoveryServicesBackupProtectionPolicy
Crea una directiva de protección de copia de seguridad.
Syntax
New-AzRecoveryServicesBackupProtectionPolicy
[-Name] <String>
[-WorkloadType] <WorkloadType>
[[-BackupManagementType] <BackupManagementType>]
[[-RetentionPolicy] <RetentionPolicyBase>]
[[-SchedulePolicy] <SchedulePolicyBase>]
[[-MoveToArchiveTier] <Boolean>]
[[-TieringMode] <TieringMode>]
[[-TierAfterDuration] <Int32>]
[[-TierAfterDurationType] <String>]
[-BackupSnapshotResourceGroup <String>]
[-BackupSnapshotResourceGroupSuffix <String>]
[-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. El cuarto y quinto comando inicializa la hora de inicio de la ventana de programación y actualiza el $schedulePolicy. Tenga en cuenta que la hora de inicio debe estar en UTC aunque la zona horaria no sea UTC. El sexto y séptimo comando actualiza el intervalo (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. 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
Type: | Nullable<T>[BackupManagementType] |
Accepted values: | AzureVM, AzureStorage, AzureWorkload |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
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 |
-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: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre de la directiva.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetentionPolicy
Especifica el objeto RetentionPolicy base. Puede usar el cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject para obtener un objeto RetentionPolicy .
Type: | RetentionPolicyBase |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SchedulePolicy
Especifica el objeto SchedulePolicy base. Puede usar el cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject para obtener un objeto SchedulePolicy .
Type: | SchedulePolicyBase |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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: | 8 |
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: | 9 |
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: | 7 |
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 |
-WorkloadType
Tipo de carga de trabajo del recurso. Los valores permitidos para este parámetro son los siguientes:
- AzureVM
- AzureFiles
- MSSQL
Type: | WorkloadType |
Accepted values: | AzureVM, AzureFiles, MSSQL |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
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]]