New-AzRecoveryServicesBackupProtectionPolicy
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>]
[-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 $SchPolIl 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 $schedulePolicyIl 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 il $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, durata (in ore) per cui 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 AzureVMEsempio 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 TierRecommendedQuesto 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 $falseQuesto 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.IDIl 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
| 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
Nome del gruppo di risorse personalizzato per archiviare i punti di ripristino istantanei delle macchine virtuali gestite. Questa opzione è facoltativa
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupSnapshotResourceGroupSuffix
Suffisso del nome del gruppo di risorse personalizzato per archiviare i punti di ripristino istantanei delle macchine virtuali gestite. Questa opzione è facoltativa
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| Type: | Nullable<T>[Boolean] |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifica il nome del criterio.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RetentionPolicy
Specifica l'oggetto RetentionPolicy di base. È possibile usare il cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject per ottenere un oggetto RetentionPolicy .
| Type: | RetentionPolicyBase |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SchedulePolicy
Specifica l'oggetto SchedulePolicy di base. È possibile usare il cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject per ottenere un oggetto SchedulePolicy .
| Type: | SchedulePolicyBase |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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
| Type: | Nullable<T>[Int32] |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TierAfterDurationType
Specifica se TierAfterDuration è espresso in giorni o mesi
| Type: | String |
| Accepted values: | Days, Months |
| Position: | 9 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TieringMode
Specifica se spostare i punti di ripristino consigliati o tutti i punti di ripristino idonei all'archivio
| Type: | TieringMode |
| Accepted values: | TierRecommended, TierAllEligible |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
ID ARM dell'insieme di credenziali di Servizi di ripristino.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkloadType
Tipo di carico di lavoro della risorsa. I valori validi per questo parametro sono:
- 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 |
Input
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]]