Get-AzRecoveryServicesBackupRecoveryPoint
Hiermee haalt u de herstelpunten voor een back-upitem op.
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>] Description
Met de cmdlet Get-AzRecoveryServicesBackupRecoveryPoint worden de herstelpunten opgehaald 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.IDMet 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 VaultArchiveMet 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 VaultStandardMet 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 AzureVMMet 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 |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
Hiermee geeft u het einde van het datumbereik.
| Type: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Item
Hiermee geeft u het item waarvoor deze cmdlet herstelpunten ophaalt. Gebruik de cmdlet Get-AzRecoveryServicesBackupItem om een AzureRmRecoveryServicesBackupItem-object te verkrijgen.
| Type: | ItemBase |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecoveryPointId
Hiermee geeft u de id van het herstelpunt op.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
Hiermee geeft u het begin van het datumbereik.
| Type: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetTier
Doellaag om de gereedheid van verplaatsing van het herstelpunt te controleren. Momenteel is alleen geldige waarde 'VaultArchive'.
| Type: | RecoveryPointTier |
| Accepted values: | VaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tier
Herstelpunten filteren op basis van laagwaarde.
| 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
Filters uit secundaire regio voor herstel tussen regio's
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
ARM-id van de Recovery Services-kluis.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |