Dela via


Get-AzRecoveryServicesBackupRecoveryPoint

Hämtar återställningspunkterna för ett säkerhetskopierat objekt.

Syntax

NoFilterParameterSet (Standard)

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

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ärde återställningspunkter förra året efter ändring av principåtgärd

$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 beskärning. 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.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EndDate

Anger slutet av datumintervallet.

Parameteregenskaper

Typ:

Nullable<T>[DateTime]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

DateTimeFilter
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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å.

Parameteregenskaper

Typ:Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NoFilterParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
DateTimeFilter
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 .

Parameteregenskaper

Typ:ItemBase
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:2
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-KeyFileDownloadLocation

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RecoveryPointId
Position:2
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RecoveryPointId

Anger återställningspunktens ID.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

RecoveryPointId
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-StartDate

Anger början av datumintervallet.

Parameteregenskaper

Typ:

Nullable<T>[DateTime]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

DateTimeFilter
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TargetTier

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

Parameteregenskaper

Typ:RecoveryPointTier
Standardvärde:None
Godkända värden:VaultArchive
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NoFilterParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
DateTimeFilter
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Tier

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

Parameteregenskaper

Typ:RecoveryPointTier
Standardvärde:None
Godkända värden:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NoFilterParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
DateTimeFilter
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-UseSecondaryRegion

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-VaultId

ARM-ID för Recovery Services-valvet.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

ItemBase

String

Utdata

RecoveryPointBase