Get-AzRecoveryServicesBackupRecoveryPoint

Syntax

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>]

Beschreibung

Das Cmdlet Get-AzRecoveryServicesBackupRecoveryPoint ruft die Wiederherstellungspunkte für ein gesichertes Azure Backup-Element ab. Nachdem ein Element gesichert wurde, weist ein AzureRmRecoveryServicesBackupRecoveryPoint-Objekt mindestens einen Wiederherstellungspunkt auf. Legen Sie den Tresorkontext mithilfe des Parameters "-VaultId" fest.

Beispiele

Beispiel 1: Abrufen von Wiederherstellungspunkten aus der letzten Woche für ein Element

$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

Der erste Befehl ruft das Tresorobjekt basierend auf vaultName ab. Der zweite Befehl ruft das Datum vor sieben Tagen ab und speichert es dann in der variablen $startDate. Der dritte Befehl ruft das heutige Datum ab und speichert ihn dann in der variablen $endDate. Der vierte Befehl ruft AzureVM-Sicherungscontainer ab und speichert sie in der $Container Variablen. Der fünfte Befehl ruft das Sicherungselement basierend auf workloadType, vaultId ab und speichert es dann in der $backupItem Variablen. Der letzte Befehl ruft ein Array von Wiederherstellungspunkten für das Element in $BackupItem ab und speichert sie dann in der $rp Variablen.

Beispiel 2: Abrufen von Wiederherstellungspunkten, die zum Verschieben in VaultArchive bereit sind

$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

Der erste Befehl ruft das Tresorobjekt basierend auf vaultName ab. Der zweite Befehl ruft das Datum vor sieben Tagen ab und speichert es dann in der variablen $startDate. Der dritte Befehl ruft das heutige Datum ab und speichert ihn dann in der variablen $endDate. Der vierte Befehl ruft Sicherungselemente basierend auf backupManagementType und workloadType, vaultId ab und speichert sie dann in der $item Variablen. Der letzte Befehl ruft ein Array von Wiederherstellungspunkten für das Element in $backupItem ab, die in die VaultArchive-Ebene verschoben werden können, und speichert sie dann in der $rp Variablen.

Beispiel 3: Abrufen von Wiederherstellungspunkten in einer bestimmten Ebene

$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

Der erste Befehl ruft das Tresorobjekt basierend auf vaultName ab. Der zweite Befehl ruft das Datum vor sieben Tagen ab und speichert es dann in der variablen $startDate. Der dritte Befehl ruft das heutige Datum ab und speichert ihn dann in der variablen $endDate. Der vierte Befehl ruft Sicherungselemente basierend auf backupManagementType und workloadType, vaultId ab und speichert sie dann in der $item Variablen. Der letzte Befehl ruft ein Array von Wiederherstellungspunkten für das Element in $backupItem ab, die in die VaultArchive-Ebene verschoben werden können, und speichert sie dann in der $rp Variablen.

Beispiel 4: Abrufen von beschnittenen Wiederherstellungspunkten im letzten Jahr nach änderung der Richtlinienopertaion

$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

Der erste Befehl ruft das Tresorobjekt basierend auf vaultName ab. Der zweite Befehl ruft das Datum vor einem Jahr ab und speichert es dann in der variablen $startDate. Der dritte Befehl ruft das heutige Datum ab und speichert ihn dann in der variablen $endDate. Der vierte Befehl ruft Sicherungselemente basierend auf backupManagementType und workloadType, vaultId ab und speichert sie dann in der $item Variablen. Der fünfte Befehl ruft ein Array von Wiederherstellungspunkten für das Element in $item ab, die vor dem Änderungsrichtlinienvorgang in den letzten ein Jahr vorhanden sind. Jetzt setzen wir fort, die Richtlinie zu aktualisieren. Mit dem sechsten Befehl wird die Richtlinie abgerufen, die zum Schutz des Sicherungselements $item[0] verwendet wird. Die siebten, acht und neunten Befehle deaktivieren die jährliche und monatliche Aufbewahrung in der Richtlinie, um die älteren Wiederherstellungspunkte zu löschen. Der zehnte Befehl aktualisiert schließlich die Aufbewahrungsrichtlinie. Der elfte Befehl wartet in derselben PowerShell-Sitzung, bis die Wiederherstellungspunkte gelöscht werden und die Wiederherstellungspunkte innerhalb des gleichen Zeitraums abgerufen werden, nachdem die Richtlinienänderungen angewendet wurden. Der Befehl "twelth" akzeptiert einen Diff zwischen der Wiederherstellungspunktliste vor und nach dem Löschen. Mit dem dreizehnten Befehl werden die Wiederherstellungspunkte aus dem Diff gelesen, die vorher vorhanden waren und jetzt gekürzt werden. Der letzte Befehl zeigt die Liste der gelöschten Wiederherstellungspunkte an.

Parameter

-DefaultProfile

-EndDate

-IsReadyForMove

-Item

-KeyFileDownloadLocation

-RecoveryPointId

-StartDate

-TargetTier

-Tier

-UseSecondaryRegion

-VaultId

Eingaben

ItemBase

String

Ausgaben

RecoveryPointBase

Ähnliche Themen

• Get-AzRecoveryServicesBackupContainer
• Get-AzRecoveryServicesBackupItem