Condividi tramite


Get-AzRecoveryServicesBackupRecoveryPoint

Ottiene i punti di ripristino per un elemento di cui è stato eseguito il backup.

Sintassi

Get-AzRecoveryServicesBackupRecoveryPoint
   [-Item] <ItemBase>
   [-UseSecondaryRegion]
   [-Tier <RecoveryPointTier>]
   [-IsReadyForMove <Boolean>]
   [-TargetTier <RecoveryPointTier>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzRecoveryServicesBackupRecoveryPoint
   [[-StartDate] <DateTime>]
   [[-EndDate] <DateTime>]
   [-Item] <ItemBase>
   [-UseSecondaryRegion]
   [-Tier <RecoveryPointTier>]
   [-IsReadyForMove <Boolean>]
   [-TargetTier <RecoveryPointTier>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzRecoveryServicesBackupRecoveryPoint
   [-Item] <ItemBase>
   [-RecoveryPointId] <String>
   [[-KeyFileDownloadLocation] <String>]
   [-UseSecondaryRegion]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-AzRecoveryServicesBackupRecoveryPoint ottiene i punti di ripristino per un elemento di backup Backup di Azure. Dopo il backup di un elemento, un oggetto AzureRmRecoveryServicesBackupRecoveryPoint ha uno o più punti di ripristino. Impostare il contesto dell'insieme di credenziali usando il parametro -VaultId.

Esempio

Esempio 1: Ottenere punti di ripristino dall'ultima settimana per un elemento

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7)
$endDate = Get-Date
$container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVM -FriendlyName "V2VM" -VaultId $vault.ID
$backupItem = Get-AzRecoveryServicesBackupItem -Container $container -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -Item $backupItem -StartDate $startdate.ToUniversalTime() -EndDate $enddate.ToUniversalTime() -VaultId $vault.ID

Il primo comando ottiene l'oggetto insieme di credenziali basato su vaultName. Il secondo comando ottiene la data da sette giorni fa e quindi la archivia nella variabile $startDate. Il terzo comando ottiene la data odierna e quindi la archivia nella variabile $endDate. Il quarto comando ottiene i contenitori di backup di AzureVM e li archivia nella variabile $Container. Il quinto comando ottiene l'elemento di backup basato su workloadType, vaultId e quindi lo archivia nella variabile $backupItem. L'ultimo comando ottiene una matrice di punti di ripristino per l'elemento in $BackupItem e quindi li archivia nella variabile $rp.

Esempio 2: Ottenere punti di ripristino pronti per essere spostati in VaultArchive

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate $startDate -EndDate $endDate -VaultId $vault.ID -Item $item[3] `
-IsReadyForMove $true -TargetTier VaultArchive

Il primo comando ottiene l'oggetto insieme di credenziali basato su vaultName. Il secondo comando ottiene la data da sette giorni fa e quindi la archivia nella variabile $startDate. Il terzo comando ottiene la data odierna e quindi la archivia nella variabile $endDate. Il quarto comando ottiene gli elementi di backup basati su backupManagementType e workloadType, vaultId e quindi li archivia nella variabile $item. L'ultimo comando ottiene una matrice di punti di ripristino per l'elemento in $backupItem che sono pronti per essere spostati nel livello VaultArchive e quindi li archivia nella variabile $rp.

Esempio 3: Ottenere punti di ripristino in un determinato livello

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate $startDate -EndDate $endDate -VaultId $vault.ID -Item $item[3] `
-Tier VaultStandard

Il primo comando ottiene l'oggetto insieme di credenziali basato su vaultName. Il secondo comando ottiene la data da sette giorni fa e quindi la archivia nella variabile $startDate. Il terzo comando ottiene la data odierna e quindi la archivia nella variabile $endDate. Il quarto comando ottiene gli elementi di backup basati su backupManagementType e workloadType, vaultId e quindi li archivia nella variabile $item. L'ultimo comando ottiene una matrice di punti di ripristino per l'elemento in $backupItem che sono pronti per essere spostati nel livello VaultArchive e quindi li archivia nella variabile $rp.

Esempio 4: Recupero dei punti di ripristino eliminati nell'ultimo anno dopo la modifica dell'opertazione dei criteri

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-365).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rpsBefore = Get-AzRecoveryServicesBackupRecoveryPoint -Item $item[0] -StartDate $startDate -EndDate $endDate -VaultId $vault.ID

# update policy
$pol = Get-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Name "policyName"
$pol.RetentionPolicy.IsWeeklyScheduleEnabled = $false
$pol.RetentionPolicy.IsMonthlyScheduleEnabled = $false
$pol.RetentionPolicy.IsYearlyScheduleEnabled = $false
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $pol -VaultId $vault.ID -RetentionPolicy $pol.RetentionPolicy -Debug 

# wait until policy changes are applied to recovery points and they are pruned
$rpsAfter = Get-AzRecoveryServicesBackupRecoveryPoint -Item $item[0] -StartDate $startDate -EndDate $endDate -VaultId $vault.ID

# compare the recovery points list before and after
$diff = Compare-Object $rpsBefore $rpsAfter
$rpsRemoved = $diff | Where-Object{ $_.SideIndicator -eq'<='} | Select-Object -ExpandProperty InputObject
$rpsRemoved

RecoveryPointId    RecoveryPointType  RecoveryPointTime      ContainerName                        ContainerType
---------------    -----------------  -----------------      -------------                        -------------
7397781054902      CrashConsistent    5/2/2023 3:28:35 AM    iaasvmcontainerv2;test-rg;test-vm  AzureVM
9722704411921      CrashConsistent    4/1/2023 3:32:26 AM    iaasvmcontainerv2;test-rg;test-vm  AzureVM
6543100104464      CrashConsistent    3/1/2023 3:26:27 AM    iaasvmcontainerv2;test-rg;test-vm  AzureVM

Il primo comando ottiene l'oggetto insieme di credenziali basato su vaultName. Il secondo comando ottiene la data di un anno fa e quindi la archivia nella variabile $startDate. Il terzo comando ottiene la data odierna e quindi la archivia nella variabile $endDate. Il quarto comando ottiene gli elementi di backup basati su backupManagementType e workloadType, vaultId e quindi li archivia nella variabile $item. Il quinto comando ottiene una matrice di punti di ripristino per l'elemento in $item presenti prima dell'operazione di modifica dei criteri nell'ultimo anno. Ora si passa ad aggiornare i criteri. Il sesto comando recupera i criteri da aggiornare che vengono usati per proteggere l'elemento di backup $item[0]. Il settimo, otto e nono comando disabilitano la conservazione annuale e mensile nei criteri per eliminare i punti di ripristino meno recenti. Il decimo comando aggiorna infine i criteri di conservazione. L'undicesimo comando attende nella stessa sessione di PowerShell fino a quando i punti di ripristino non vengono eliminati e recupera i punti di ripristino all'interno dello stesso intervallo di tempo, dopo l'applicazione delle modifiche ai criteri. Il comando twelth accetta una differenza tra l'elenco di punti di ripristino prima e dopo l'eliminazione. Il tredicesimo comando legge i punti di ripristino, dalla diff, che erano presenti prima e sono ora eliminati. L'ultimo comando visualizza l'elenco dei punti di ripristino eliminati.

Parametri

-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

-EndDate

Specifica la fine dell'intervallo di date.

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

-IsReadyForMove

Filtra i punti di ripristino in base al fatto che rp sia pronto per passare al livello di destinazione. Usare questo insieme al parametro del livello di destinazione.

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

-Item

Specifica l'elemento per il quale questo cmdlet ottiene i punti di ripristino. Per ottenere un oggetto AzureRmRecoveryServicesBackupItem , usare il cmdlet Get-AzRecoveryServicesBackupItem .

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

-KeyFileDownloadLocation

Specifica il percorso in cui scaricare il file di input per ripristinare la chiave keyVault per una macchina virtuale crittografata.

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

-RecoveryPointId

Specifica l'ID del punto di ripristino.

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

-StartDate

Specifica l'inizio dell'intervallo di date.

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

-TargetTier

Livello di destinazione per controllare la conformità dello spostamento del punto di ripristino. Attualmente solo il valore valido è 'VaultArchive'.

Tipo:RecoveryPointTier
Valori accettati:VaultArchive
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tier

Filtrare i punti di ripristino in base al valore del livello.

Tipo:RecoveryPointTier
Valori accettati:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseSecondaryRegion

Filtri dall'area secondaria per il ripristino tra aree

Tipo:SwitchParameter
Posizione:Named
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

Input

ItemBase

String

Output

RecoveryPointBase