Get-AzRecoveryServicesBackupRecoveryPoint
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 usługi Azure Backup. 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.IDPierwsze 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 VaultArchivePierwsze 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 VaultStandardPierwsze 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 AzureVMPierwsze 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.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
Określa koniec zakresu dat.
| Type: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Item
Określa element, dla którego to polecenie cmdlet pobiera punkty odzyskiwania. Aby uzyskać obiekt AzureRmRecoveryServicesBackupItem , użyj polecenia cmdlet Get-AzRecoveryServicesBackupItem .
| Type: | ItemBase |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFileDownloadLocation
Określa lokalizację pobierania pliku wejściowego w celu przywrócenia klucza keyVault dla zaszyfrowanej maszyny wirtualnej.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecoveryPointId
Określa identyfikator punktu odzyskiwania.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
Określa początek zakresu dat.
| Type: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetTier
Warstwa docelowa w celu sprawdzenia gotowości punktu odzyskiwania. Obecnie prawidłowa wartość to "VaultArchive".
| Type: | RecoveryPointTier |
| Accepted values: | VaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tier
Filtrowanie punktów odzyskiwania na podstawie wartości warstwy.
| 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
Filtry z regionu pomocniczego do przywracania między regionami
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
Identyfikator ARM magazynu usługi Recovery Services.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |