Delen via


Get-AzRecoveryServicesBackupRecoveryPoint

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

Syntaxis

NoFilterParameterSet (Standaard)

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

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.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: Herstelpunten verwijderen uit vorig jaar na het wijzigen van de beleidsbewerking

$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 de lijst met herstelpunten 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.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EndDate

Hiermee geeft u het einde van het datumbereik.

Parametereigenschappen

Type:

Nullable<T>[DateTime]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DateTimeFilter
Position:1
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IsReadyForMove

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

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NoFilterParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
DateTimeFilter
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Item

Hiermee geeft u het item waarvoor deze cmdlet herstelpunten ophaalt. Gebruik de cmdlet Get-AzRecoveryServicesBackupItem om een AzureRmRecoveryServicesBackupItem-object te verkrijgen.

Parametereigenschappen

Type:ItemBase
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-KeyFileDownloadLocation

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RecoveryPointId
Position:2
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RecoveryPointId

Hiermee geeft u de id van het herstelpunt op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RecoveryPointId
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-StartDate

Hiermee geeft u het begin van het datumbereik.

Parametereigenschappen

Type:

Nullable<T>[DateTime]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DateTimeFilter
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TargetTier

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

Parametereigenschappen

Type:RecoveryPointTier
Default value:None
Geaccepteerde waarden:VaultArchive
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NoFilterParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
DateTimeFilter
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Tier

Herstelpunten filteren op basis van laagwaarde.

Parametereigenschappen

Type:RecoveryPointTier
Default value:None
Geaccepteerde waarden:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NoFilterParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
DateTimeFilter
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-UseSecondaryRegion

Filters uit secundaire regio voor herstel tussen regio's

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-VaultId

ARM-id van de Recovery Services-kluis.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

ItemBase

String

Uitvoerwaarden

RecoveryPointBase