Condividi tramite

Get-AzRecoveryServicesBackupRecoveryPoint

Modulo:
Az.RecoveryServices Module

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

Sintassi

NoFilterParameterSet (impostazione predefinita). 

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

DateTimeFilter 

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

RecoveryPointId 

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'operazione 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 dodicesimo comando 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.

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

-EndDate

Specifica la fine dell'intervallo di date.

Proprietà dei parametri

Tipo:

Nullable<T>[DateTime]

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

Set di parametri

DateTimeFilter
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

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

Set di parametri

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

Proprietà dei parametri

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

Set di parametri

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

-KeyFileDownloadLocation

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

Proprietà dei parametri

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

Set di parametri

RecoveryPointId
Posizione:2
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RecoveryPointId

Specifica l'ID del punto di ripristino.

Proprietà dei parametri

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

Set di parametri

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

-StartDate

Specifica l'inizio dell'intervallo di date.

Proprietà dei parametri

Tipo:

Nullable<T>[DateTime]

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

Set di parametri

DateTimeFilter
Posizione:0
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TargetTier

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

Proprietà dei parametri

Tipo:RecoveryPointTier
Valore predefinito:None
Valori accettati:VaultArchive
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

NoFilterParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
DateTimeFilter
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Tier

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

Proprietà dei parametri

Tipo:RecoveryPointTier
Valore predefinito:None
Valori accettati:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

NoFilterParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
DateTimeFilter
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UseSecondaryRegion

Filtri dall'area secondaria per il ripristino tra aree

Proprietà dei parametri

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

-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

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

ItemBase

String

Output

RecoveryPointBase