Condividi tramite

New-AzRecoveryServicesBackupProtectionPolicy

  • Riferimento
Modulo:
Az.RecoveryServices

Crea un criterio di protezione di backup.

Sintassi

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>]

Descrizione

Il cmdlet New-AzRecoveryServicesBackupProtectionPolicy crea un criterio di protezione backup in un insieme di credenziali. Un criterio di protezione è associato ad almeno un criterio di conservazione. I criteri di conservazione definiscono per quanto tempo un punto di ripristino viene mantenuto nel servizio Backup di Azure. È possibile usare il cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject per ottenere i criteri di conservazione predefiniti. È anche possibile usare il cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject per ottenere i criteri di pianificazione predefiniti. Gli oggetti SchedulePolicy e RetentionPolicy vengono usati come input per il cmdlet New-AzRecoveryServicesBackupProtectionPolicy . Impostare il contesto dell'insieme di credenziali usando il cmdlet Set-AzRecoveryServicesVaultContext prima di usare il cmdlet corrente.

Esempio

Esempio 1: Creare un criterio di protezione backup

$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

Il primo comando ottiene un oggetto SchedulePolicyObject di base e quindi lo archivia nella variabile $SchPol. Il secondo comando rimuove tutti i tempi di esecuzione pianificati dai criteri di pianificazione in $SchPol. Il terzo comando usa il cmdlet Get-Date per ottenere la data e l'ora correnti. Il quarto comando aggiunge la data e l'ora correnti in $Dt come ora di esecuzione pianificata ai criteri di pianificazione. Il quinto comando ottiene un oggetto RetentionPolicy di base e quindi lo archivia nella variabile $RetPol. Il sesto comando imposta i criteri di durata della conservazione su 365 giorni. Il comando finale crea un oggetto BackupProtectionPolicy in base ai criteri di pianificazione e conservazione creati dai comandi precedenti.

Esempio 2: Creare un criterio di condivisione file per più backup al giorno

$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

Il primo comando ottiene un oggetto SchedulePolicyObject di base oraria e quindi lo archivia nella variabile $schedulePolicy. Il secondo e il terzo comando recupera il fuso orario e aggiorna il fuso orario nel $schedulePolicy. Il quarto e quinto comando inizializza l'ora di inizio dell'intervallo di pianificazione e aggiorna $schedulePolicy. Si noti che l'ora di inizio deve essere in formato UTC anche se il fuso orario non è UTC. Il sesto e il settimo comando aggiornano l'intervallo (in ore) dopo il quale il backup verrà ritentato nello stesso giorno e la durata (in ore) per la quale verrà eseguita la pianificazione. L'ottavo comando ottiene un oggetto RetentionPolicy di base ogni ora e quindi lo archivia nella variabile $retentionPolicy. Il nono comando imposta i criteri di durata della conservazione su 10 giorni. Il comando finale crea un oggetto BackupProtectionPolicy in base ai criteri di pianificazione e conservazione creati dai comandi precedenti.

Esempio 3

Crea un criterio di protezione di backup. (generato automaticamente)

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

Esempio 4: Creare nuovi criteri di AzureVM per abilitare l'archiviazione intelligente a livelli con TieringMode TierRecommended

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

Questo comando viene usato per creare criteri per abilitare la suddivisione in livelli intelligente dell'archivio per la modalità di suddivisione in livelli TierRecommended, il parametro -MoveToArchiveTier viene impostato su $true per abilitare la suddivisione in livelli intelligente. È stato impostato TieringMode su TierRecommended per spostare tutti i punti di ripristino consigliati nell'archivio. Si noti che la modalità di suddivisione in livelli TierRecommended è supportata solo per il tipo di carico di lavoro AzureVM.

Esempio 5: Creare nuovi criteri con l'archiviazione a livelli intelligenti disabilitata

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

Questo comando viene usato per disabilitare l'archiviazione della suddivisione in livelli intelligente durante la creazione di un criterio, il parametro MoveToArchiveTier viene impostato su $false per disabilitare la suddivisione in livelli.

Esempio 6: Creare un criterio standard di fuso orario non UTC per 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

Il primo comando ottiene un Oggetto SchedulePolicyObject e quindi lo archivia nella variabile $schedulePolicy. Il secondo blocco di comandi recupera il fuso orario e datetime (localtime contrassegnato come UTC) e aggiorna il fuso orario e l'ora nel $schedulePolicy. Si noti che datetime deve sempre essere contrassegnato come UTC perché il fuso orario viene specificato separatamente. Si noti anche che per altri tipi di carico di lavoro il fuso orario deve essere specificato nell'attributo $schedulePolicy.ScheduleRunTimeZone. Il terzo blocco di comandi aggiorna i criteri di pianificazione differenziale. Si ottengono quindi le impostazioni di conservazione RetentionPolicyObject e si aggiornano le impostazioni di conservazione differenziale e completa del backup. Infine, viene creato un oggetto BackupProtectionPolicy in base ai criteri di pianificazione e conservazione creati dai comandi precedenti.

Parametri

-BackupManagementType

Classe di risorse protette. I valori validi per questo parametro sono:

  • AzureVM
  • AzureStorage
  • AzureWorkload
Tipo:Nullable<T>[BackupManagementType]
Valori accettati:AzureVM, AzureStorage, AzureWorkload
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-BackupSnapshotResourceGroup

Nome del gruppo di risorse personalizzato per archiviare i punti di ripristino istantanei delle macchine virtuali gestite. Questa opzione è facoltativa

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BackupSnapshotResourceGroupSuffix

Suffisso del nome del gruppo di risorse personalizzato per archiviare i punti di ripristino istantanei delle macchine virtuali gestite. Questa opzione è facoltativa

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MoveToArchiveTier

Specifica se i punti di ripristino devono essere spostati nell'archivio di archiviazione in base al criterio o meno. I valori consentiti sono $true, $false

Tipo:Nullable<T>[Boolean]
Posizione:6
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome del criterio.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RetentionPolicy

Specifica l'oggetto RetentionPolicy di base. È possibile usare il cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject per ottenere un oggetto RetentionPolicy .

Tipo:RetentionPolicyBase
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SchedulePolicy

Specifica l'oggetto SchedulePolicy di base. È possibile usare il cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject per ottenere un oggetto SchedulePolicy .

Tipo:SchedulePolicyBase
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SnapshotConsistencyType

Tipo di coerenza dello snapshot da usare per il backup. Se impostato su OnlyCrashConsistent, tutti gli elementi associati avranno uno snapshot coerente con l'arresto anomalo del sistema. I valori possibili sono OnlyCrashConsistent, Default

Tipo:SnapshotConsistencyType
Valori accettati:Default, OnlyCrashConsistent
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TierAfterDuration

Specifica la durata dopo la quale i punti di ripristino devono iniziare a passare al livello archivio, il valore può essere espresso in giorni o mesi. Applicabile solo quando TieringMode è TierAllEligible

Tipo:Nullable<T>[Int32]
Posizione:8
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TierAfterDurationType

Specifica se TierAfterDuration è espresso in giorni o mesi

Tipo:String
Valori accettati:Days, Months
Posizione:9
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TieringMode

Specifica se spostare i punti di ripristino consigliati o tutti i punti di ripristino idonei all'archivio

Tipo:TieringMode
Valori accettati:TierRecommended, TierAllEligible
Posizione:7
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VaultId

ID ARM dell'insieme di credenziali di Servizi di ripristino.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WorkloadType

Tipo di carico di lavoro della risorsa. I valori validi per questo parametro sono:

  • AzureVM
  • AzureFiles
  • MSSQL
Tipo:WorkloadType
Valori accettati:AzureVM, AzureFiles, MSSQL
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

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

Output

PolicyBase