Udostępnij za pośrednictwem

Get-AzRecoveryServicesBackupRecoveryPoint

  • Odwołanie
Moduł:
Az.RecoveryServices

Pobiera punkty odzyskiwania dla elementu kopii zapasowej.

Składnia

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

Opis

Polecenie cmdlet Get-AzRecoveryServicesBackupRecoveryPoint pobiera punkty odzyskiwania dla elementu kopii zapasowej azure. Po utworzeniu kopii zapasowej elementu obiekt AzureRmRecoveryServicesBackupRecoveryPoint ma co najmniej jeden punkt odzyskiwania. Ustaw kontekst magazynu przy użyciu parametru -VaultId.

Przykłady

Przykład 1: Pobieranie punktów odzyskiwania z ostatniego tygodnia dla elementu

$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

Pierwsze polecenie pobiera obiekt magazynu na podstawie vaultName. Drugie polecenie pobiera datę z siedmiu dni temu, a następnie zapisuje ją w zmiennej $startDate. Trzecie polecenie pobiera bieżącą datę, a następnie zapisuje je w zmiennej $endDate. Czwarte polecenie pobiera kontenery kopii zapasowych maszyny wirtualnej AzureVM i przechowuje je w zmiennej $Container. Piąte polecenie pobiera element kopii zapasowej na podstawie parametru workloadType, vaultId, a następnie zapisuje go w zmiennej $backupItem. Ostatnie polecenie pobiera tablicę punktów odzyskiwania dla elementu w $BackupItem, a następnie przechowuje je w zmiennej $rp.

Przykład 2. Pobieranie punktów odzyskiwania gotowych do przeniesienia do magazynuArchive

$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

Pierwsze polecenie pobiera obiekt magazynu na podstawie vaultName. Drugie polecenie pobiera datę z siedmiu dni temu, a następnie zapisuje ją w zmiennej $startDate. Trzecie polecenie pobiera bieżącą datę, a następnie zapisuje je w zmiennej $endDate. Czwarte polecenie pobiera elementy kopii zapasowej na podstawie elementu backupManagementType i workloadType, vaultId, a następnie zapisuje je w zmiennej $item. Ostatnie polecenie pobiera tablicę punktów odzyskiwania dla elementu w $backupItem, które są gotowe do przeniesienia do warstwy VaultArchive, a następnie przechowuje je w zmiennej $rp.

Przykład 3. Pobieranie punktów odzyskiwania w określonej warstwie

$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

Pierwsze polecenie pobiera obiekt magazynu na podstawie vaultName. Drugie polecenie pobiera datę z siedmiu dni temu, a następnie zapisuje ją w zmiennej $startDate. Trzecie polecenie pobiera bieżącą datę, a następnie zapisuje je w zmiennej $endDate. Czwarte polecenie pobiera elementy kopii zapasowej na podstawie elementu backupManagementType i workloadType, vaultId, a następnie zapisuje je w zmiennej $item. Ostatnie polecenie pobiera tablicę punktów odzyskiwania dla elementu w $backupItem, które są gotowe do przeniesienia do warstwy VaultArchive, a następnie przechowuje je w zmiennej $rp.

Przykład 4: Pobieranie przycinanych punktów odzyskiwania w zeszłym roku po zmodyfikowaniu opertaionu zasad

$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

Pierwsze polecenie pobiera obiekt magazynu na podstawie vaultName. Drugie polecenie pobiera datę z jednego roku temu, a następnie zapisuje ją w zmiennej $startDate. Trzecie polecenie pobiera bieżącą datę, a następnie zapisuje je w zmiennej $endDate. Czwarte polecenie pobiera elementy kopii zapasowej na podstawie elementu backupManagementType i workloadType, vaultId, a następnie zapisuje je w zmiennej $item. Piąte polecenie pobiera tablicę punktów odzyskiwania dla elementu w $item, które znajdują się przed operacją modyfikowania zasad w ciągu ostatniego roku. Teraz przejdziemy do aktualizacji zasad. Szóste polecenie pobiera zasady do zaktualizowania, które są używane do ochrony elementu kopii zapasowej $item[0]. Siódme, osiem i dziewiąte polecenia wyłączają roczne i miesięczne przechowywanie w zasadach w celu oczyszczenia starszych punktów odzyskiwania. Dziesiąte polecenie na koniec aktualizuje zasady przechowywania. Jedenaście poleceń czeka w tej samej sesji programu PowerShell do momentu oczyszczenia punktów odzyskiwania i pobrania punktów odzyskiwania w tym samym zakresie czasu po zastosowaniu zmian zasad. Polecenie twelth pobiera różnice między listą punktów odzyskiwania przed i po zakończeniu oczyszczania. Trzynaste polecenie odczytuje punkty odzyskiwania z różnic, które były obecne wcześniej i są teraz przycinane. Ostatnie polecenie wyświetla listę przycinanych punktów odzyskiwania.

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EndDate

Określa koniec zakresu dat.

Typ:Nullable<T>[DateTime]
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IsReadyForMove

Filtruje punkty odzyskiwania na podstawie tego, czy punkt odzyskiwania jest gotowy do przejścia do warstwy docelowej. Użyj tego parametru wraz z parametrem warstwy docelowej.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Item

Określa element, dla którego to polecenie cmdlet pobiera punkty odzyskiwania. Aby uzyskać obiekt AzureRmRecoveryServicesBackupItem, użyj polecenia cmdlet Get-AzRecoveryServicesBackupItem.

Typ:ItemBase
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-KeyFileDownloadLocation

Określa lokalizację pobierania pliku wejściowego w celu przywrócenia klucza keyVault dla zaszyfrowanej maszyny wirtualnej.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RecoveryPointId

Określa identyfikator punktu odzyskiwania.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StartDate

Określa początek zakresu dat.

Typ:Nullable<T>[DateTime]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetTier

Warstwa docelowa w celu sprawdzenia gotowości punktu odzyskiwania. Obecnie prawidłowa wartość to "VaultArchive".

Typ:RecoveryPointTier
Dopuszczalne wartości:VaultArchive
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tier

Filtrowanie punktów odzyskiwania na podstawie wartości warstwy.

Typ:RecoveryPointTier
Dopuszczalne wartości:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UseSecondaryRegion

Filtry z regionu pomocniczego do przywracania między regionami

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VaultId

Identyfikator ARM magazynu usługi Recovery Services.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

ItemBase

String

Dane wyjściowe

RecoveryPointBase