Condividi tramite


New-AzRecoveryServicesBackupProtectionPolicy

Crea un criterio di protezione di backup.

Sintassi

Default (impostazione predefinita).

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. (autogenerated)

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 accettabili per questo parametro sono:

  • AzureVM
  • AzureStorage
  • AzureWorkload

Proprietà dei parametri

Tipo:

Nullable<T>[BackupManagementType]

Valore predefinito:None
Valori accettati:AzureVM, AzureStorage, AzureWorkload
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-BackupSnapshotResourceGroup

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-BackupSnapshotResourceGroupSuffix

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:6
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome del criterio.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RetentionPolicy

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

Proprietà dei parametri

Tipo:RetentionPolicyBase
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:4
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-SchedulePolicy

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

Proprietà dei parametri

Tipo:SchedulePolicyBase
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:5
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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

Proprietà dei parametri

Tipo:SnapshotConsistencyType
Valore predefinito:None
Valori accettati:Default, OnlyCrashConsistent
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:8
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TierAfterDurationType

Specifica se TierAfterDuration è espresso in giorni o mesi

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Days, Months
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:9
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TieringMode

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

Proprietà dei parametri

Tipo:TieringMode
Valore predefinito:None
Valori accettati:TierRecommended, TierAllEligible
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:7
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VaultId

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WorkloadType

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

  • AzureVM
  • AzureFiles
  • MSSQL

Proprietà dei parametri

Tipo:WorkloadType
Valore predefinito:None
Valori accettati:AzureVM, AzureFiles, MSSQL
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

WorkloadType

Nullable<T>

RetentionPolicyBase

SchedulePolicyBase

String

Output

PolicyBase