Get-AzRecoveryServicesBackupRecoveryPoint
Ruft die Wiederherstellungspunkte für ein gesichertes Element ab.
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.IDDer 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 VaultArchiveDer 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 VaultStandardDer 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 AzureVMDer 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
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
Gibt das Ende des Datumsbereichs an.
| Type: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsReadyForMove
Filtert die Wiederherstellungspunkte basierend darauf, ob RP bereit ist, zur Zielebene zu wechseln. Verwenden Sie diese Zusammen mit dem Parameter "Zielebene".
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Item
Gibt das Element an, für das dieses Cmdlet Wiederherstellungspunkte abruft. Verwenden Sie das Cmdlet Get-AzRecoveryServicesBackupItem, um ein AzureRmRecoveryServicesBackupItem-Objekt abzurufen.
| Type: | ItemBase |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFileDownloadLocation
Gibt den Speicherort an, an dem die Eingabedatei heruntergeladen werden soll, um den KeyVault-Schlüssel für einen verschlüsselten virtuellen Computer wiederherzustellen.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecoveryPointId
Gibt die Wiederherstellungspunkt-ID an.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
Gibt den Anfang des Datumsbereichs an.
| Type: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetTier
Zielebene, um die Verschiebungsbereitschaft des Wiederherstellungspunkts zu überprüfen. Derzeit ist nur gültiger Wert "VaultArchive".
| Type: | RecoveryPointTier |
| Accepted values: | VaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tier
Filtert Wiederherstellungspunkte basierend auf dem Ebenenwert.
| Type: | RecoveryPointTier |
| Accepted values: | VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseSecondaryRegion
Filter aus sekundärer Region für die Wiederherstellung der regionübergreifenden Region
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
ARM-ID des Recovery Services Vault.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Eingaben
Ausgaben
Ähnliche Themen
Azure PowerShell
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für