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.IDIl 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 VaultArchiveIl 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 VaultStandardIl 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 AzureVMIl 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 |