Get-AzRecoveryServicesBackupRecoveryPoint
Hämtar återställningspunkterna för ett säkerhetskopierat objekt.
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
Cmdleten Get-AzRecoveryServicesBackupRecoveryPoint hämtar återställningspunkterna för ett säkerhetskopierat Azure Backup-objekt. När ett objekt har säkerhetskopierats har ett AzureRmRecoveryServicesBackupRecoveryPoint-objekt en eller flera återställningspunkter. Ange valvkontexten med parametern -VaultId.
Exempel
Exempel 1: Hämta återställningspunkter från den senaste veckan för ett objekt
$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.IDDet första kommandot hämtar valvobjekt baserat på vaultName. Det andra kommandot hämtar datumet från sju dagar sedan och lagrar det sedan i variabeln $startDate. Det tredje kommandot hämtar dagens datum och lagrar det sedan i variabeln $endDate. Det fjärde kommandot hämtar AzureVM-säkerhetskopieringscontainrar och lagrar dem i variabeln $Container. Det femte kommandot hämtar säkerhetskopieringsobjektet baserat på workloadType, vaultId och lagrar det sedan i variabeln $backupItem. Det sista kommandot hämtar en matris med återställningspunkter för objektet i $BackupItem och lagrar dem sedan i variabeln $rp.
Exempel 2: Hämta återställningspunkter som är redo att flyttas till 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 VaultArchiveDet första kommandot hämtar valvobjekt baserat på vaultName. Det andra kommandot hämtar datumet från sju dagar sedan och lagrar det sedan i variabeln $startDate. Det tredje kommandot hämtar dagens datum och lagrar det sedan i variabeln $endDate. Det fjärde kommandot hämtar säkerhetskopieringsobjekt baserat på backupManagementType och workloadType, vaultId och lagrar dem sedan i variabeln $item. Det sista kommandot hämtar en matris med återställningspunkter för objektet i $backupItem som är redo att flyttas till VaultArchive-nivån och sedan lagrar dem i variabeln $rp.
Exempel 3: Hämta återställningspunkter på en viss nivå
$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 VaultStandardDet första kommandot hämtar valvobjekt baserat på vaultName. Det andra kommandot hämtar datumet från sju dagar sedan och lagrar det sedan i variabeln $startDate. Det tredje kommandot hämtar dagens datum och lagrar det sedan i variabeln $endDate. Det fjärde kommandot hämtar säkerhetskopieringsobjekt baserat på backupManagementType och workloadType, vaultId och lagrar dem sedan i variabeln $item. Det sista kommandot hämtar en matris med återställningspunkter för objektet i $backupItem som är redo att flyttas till VaultArchive-nivån och sedan lagrar dem i variabeln $rp.
Exempel 4: Hämta beskärda återställningspunkter förra året efter ändring av principopertaion
$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 AzureVMDet första kommandot hämtar valvobjekt baserat på vaultName. Det andra kommandot hämtar datumet från för ett år sedan och lagrar det sedan i variabeln $startDate. Det tredje kommandot hämtar dagens datum och lagrar det sedan i variabeln $endDate. Det fjärde kommandot hämtar säkerhetskopieringsobjekt baserat på backupManagementType och workloadType, vaultId och lagrar dem sedan i variabeln $item. Det femte kommandot hämtar en matris med återställningspunkter för objektet i $item som finns före ändringsprincipåtgärden under det senaste året. Nu går vi vidare för att uppdatera principen. Det sjätte kommandot hämtar principen som ska uppdateras som används för att skydda säkerhetskopieringsobjektet $item[0]. De sjunde, åtta och nionde kommandona inaktiverar den årliga och månatliga kvarhållningen i principen för att rensa de äldre återställningspunkterna. Det tionde kommandot uppdaterar slutligen kvarhållningsprincipen. Det elfte kommandot väntar i samma PowerShell-session tills återställningspunkterna rensas och hämtar återställningspunkterna inom samma tidsintervall, efter att principändringarna har tillämpats. Det tolfte kommandot tar ett diff mellan återställningspunktslistan före och efter att rensningen har inträffat. Det trettonde kommandot läste återställningspunkterna, från diffen, som fanns före och nu beskärs. Det sista kommandot visar listan över beskärta återställningspunkter.
Parametrar
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
Anger slutet av datumintervallet.
| Type: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsReadyForMove
Filtrerar återställningspunkterna baserat på om RP är redo att flyttas till målnivån. Använd detta tillsammans med parametern för målnivå.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Item
Anger det objekt som den här cmdleten hämtar återställningspunkter för. Om du vill hämta ett AzureRmRecoveryServicesBackupItem-objekt använder du cmdleten Get-AzRecoveryServicesBackupItem .
| Type: | ItemBase |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFileDownloadLocation
Anger platsen där indatafilen ska laddas ned för att återställa KeyVault-nyckeln för en krypterad virtuell dator.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecoveryPointId
Anger återställningspunktens ID.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
Anger början av datumintervallet.
| Type: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetTier
Målnivå för att kontrollera flyttberedskapen för återställningspunkten. För närvarande är endast giltigt värde "VaultArchive".
| Type: | RecoveryPointTier |
| Accepted values: | VaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tier
Filtrera återställningspunkter baserat på nivåvärde.
| 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 från sekundär region för återställning mellan regioner
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
ARM-ID för Recovery Services-valvet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |