Dela via

Get-AzRecoveryServicesBackupRecoveryPoint

  • Referens
Modul:
Az.RecoveryServices

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.ID

Det 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 VaultArchive

Det 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 VaultStandard

Det 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  AzureVM

Det 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.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EndDate

Anger slutet av datumintervallet.

Typ:Nullable<T>[DateTime]
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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å.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:ItemBase
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-KeyFileDownloadLocation

Anger platsen där indatafilen ska laddas ned för att återställa KeyVault-nyckeln för en krypterad virtuell dator.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RecoveryPointId

Anger återställningspunktens ID.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StartDate

Anger början av datumintervallet.

Typ:Nullable<T>[DateTime]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetTier

Målnivå för att kontrollera flyttberedskapen för återställningspunkten. För närvarande är endast giltigt värde "VaultArchive".

Typ:RecoveryPointTier
Godkända värden:VaultArchive
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tier

Filtrera återställningspunkter baserat på nivåvärde.

Typ:RecoveryPointTier
Godkända värden:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseSecondaryRegion

Filter från sekundär region för återställning mellan regioner

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VaultId

ARM-ID för Recovery Services-valvet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

ItemBase

String

Utdata

RecoveryPointBase