Delen via

Get-AzRecoveryServicesBackupRecoveryPoint

  • Referentie
Module:
Az.RecoveryServices

Hiermee haalt u de herstelpunten voor een back-upitem op.

Syntaxis

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

Description

De Get-AzRecoveryServicesBackupRecoveryPoint cmdlet haalt de herstelpunten op voor een back-up van een Azure Backup-item. Nadat een back-up van een item is gemaakt, heeft een AzureRmRecoveryServicesBackupRecoveryPoint-object een of meer herstelpunten. Stel de kluiscontext in met behulp van de parameter -VaultId.

Voorbeelden

Voorbeeld 1: Herstelpunten ophalen uit de afgelopen week voor een item

$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

Met de eerste opdracht wordt kluisobject opgehaald op basis van vaultName. Met de tweede opdracht wordt de datum van zeven dagen geleden opgehaald en vervolgens opgeslagen in de variabele $startDate. Met de derde opdracht wordt de datum van vandaag opgeslagen en vervolgens opgeslagen in de $endDate variabele. Met de vierde opdracht worden AzureVM-back-upcontainers opgehaald en opgeslagen in de $Container variabele. Met de vijfde opdracht wordt het back-upitem opgehaald op basis van workloadType, vaultId en wordt het vervolgens opgeslagen in de variabele $backupItem. Met de laatste opdracht wordt een matrix met herstelpunten voor het item in $BackupItem opgeslagen en vervolgens opgeslagen in de variabele $rp.

Voorbeeld 2: Herstelpunten ophalen die gereed zijn om te worden verplaatst naar 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

Met de eerste opdracht wordt kluisobject opgehaald op basis van vaultName. Met de tweede opdracht wordt de datum van zeven dagen geleden opgehaald en vervolgens opgeslagen in de variabele $startDate. Met de derde opdracht wordt de datum van vandaag opgeslagen en vervolgens opgeslagen in de $endDate variabele. Met de vierde opdracht worden back-upitems opgehaald op basis van backupManagementType en workloadType, vaultId en worden deze vervolgens opgeslagen in de variabele $item. Met de laatste opdracht wordt een matrix met herstelpunten opgehaald voor het item in $backupItem die klaar zijn om te worden verplaatst naar de VaultArchive-laag en deze vervolgens opslaat in de $rp variabele.

Voorbeeld 3: Herstelpunten ophalen in een bepaalde laag

$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

Met de eerste opdracht wordt kluisobject opgehaald op basis van vaultName. Met de tweede opdracht wordt de datum van zeven dagen geleden opgehaald en vervolgens opgeslagen in de variabele $startDate. Met de derde opdracht wordt de datum van vandaag opgeslagen en vervolgens opgeslagen in de $endDate variabele. Met de vierde opdracht worden back-upitems opgehaald op basis van backupManagementType en workloadType, vaultId en worden deze vervolgens opgeslagen in de variabele $item. Met de laatste opdracht wordt een matrix met herstelpunten opgehaald voor het item in $backupItem die klaar zijn om te worden verplaatst naar de VaultArchive-laag en deze vervolgens opslaat in de $rp variabele.

Voorbeeld 4: Het verwijderen van herstelpunten in het afgelopen jaar na het wijzigen van beleidsopertaion

$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

Met de eerste opdracht wordt kluisobject opgehaald op basis van vaultName. Met de tweede opdracht wordt de datum van één jaar geleden opgehaald en vervolgens opgeslagen in de variabele $startDate. Met de derde opdracht wordt de datum van vandaag opgeslagen en vervolgens opgeslagen in de $endDate variabele. Met de vierde opdracht worden back-upitems opgehaald op basis van backupManagementType en workloadType, vaultId en worden deze vervolgens opgeslagen in de variabele $item. Met de vijfde opdracht krijgt u een matrix met herstelpunten voor het item in $item die aanwezig zijn vóór de bewerking voor het wijzigen van het beleid in het afgelopen jaar. Nu gaan we verder met het bijwerken van het beleid. Met de zesde opdracht wordt het beleid opgehaald dat moet worden bijgewerkt. Dit wordt gebruikt om het back-upitem te beveiligen $item[0]. Met de zevende, acht en negende opdrachten wordt de jaarlijkse en maandelijkse bewaarperiode in het beleid uitgeschakeld om de oudere herstelpunten te verwijderen. Met de tiende opdracht wordt het bewaarbeleid ten slotte bijgewerkt. De elfde opdracht wacht in dezelfde PowerShell-sessie totdat de herstelpunten worden verwijderd en de herstelpunten binnen hetzelfde tijdsbereik worden opgehaald, nadat de beleidswijzigingen zijn toegepast. De twaalfde opdracht neemt een verschil tussen herstelpuntenlijst voor en na het verwijderen. De dertiende opdracht leest de herstelpunten uit de diff, die eerder aanwezig waren en nu worden verwijderd. Met de laatste opdracht wordt de lijst met herstelde herstelpunten weergegeven.

Parameters

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EndDate

Hiermee geeft u het einde van het datumbereik.

Type:Nullable<T>[DateTime]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IsReadyForMove

Filtert de herstelpunten op basis van of RP gereed is om naar de doellaag te gaan. Gebruik deze samen met de doellaagparameter.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Item

Hiermee geeft u het item waarvoor deze cmdlet herstelpunten ophaalt. Als u een AzureRmRecoveryServicesBackupItem--object wilt verkrijgen, gebruikt u de cmdlet Get-AzRecoveryServicesBackupItem.

Type:ItemBase
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-KeyFileDownloadLocation

Hiermee geeft u de locatie op om het invoerbestand te downloaden om de KeyVault-sleutel voor een versleutelde virtuele machine te herstellen.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RecoveryPointId

Hiermee geeft u de id van het herstelpunt op.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StartDate

Hiermee geeft u het begin van het datumbereik.

Type:Nullable<T>[DateTime]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TargetTier

Doellaag om de gereedheid van verplaatsing van het herstelpunt te controleren. Momenteel is alleen geldige waarde 'VaultArchive'.

Type:RecoveryPointTier
Geaccepteerde waarden:VaultArchive
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tier

Herstelpunten filteren op basis van laagwaarde.

Type:RecoveryPointTier
Geaccepteerde waarden:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseSecondaryRegion

Filters uit secundaire regio voor herstel tussen regio's

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VaultId

ARM-id van de Recovery Services-kluis.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

ItemBase

String

Uitvoerwaarden

RecoveryPointBase