Get-AzRecoveryServicesBackupRecoveryPoint

Syntaxe

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

L’applet de commande Get-AzRecoveryServicesBackupRecoveryPoint obtient les points de récupération d’un élément sauvegardé Sauvegarde Azure. Une fois qu’un élément a été sauvegardé, un objet AzureRmRecoveryServicesBackupRecoveryPoint a un ou plusieurs points de récupération. Définissez le contexte du coffre à l’aide du paramètre -VaultId.

Exemples

Exemple 1 : Obtenir des points de récupération de la semaine dernière pour un élément

$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

La première commande obtient l’objet de coffre en fonction de vaultName. La deuxième commande obtient la date d’il y a sept jours, puis la stocke dans la variable $startDate. La troisième commande obtient la date d’aujourd’hui, puis la stocke dans la variable $endDate. La quatrième commande obtient les conteneurs de sauvegarde AzureVM et les stocke dans la variable $Container. La cinquième commande obtient l’élément de sauvegarde basé sur workloadType, vaultId, puis le stocke dans la variable $backupItem. La dernière commande obtient un tableau de points de récupération pour l’élément dans $BackupItem, puis les stocke dans la variable $rp.

Exemple 2 : Obtenir des points de récupération prêts à être déplacés vers 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

La première commande obtient l’objet de coffre en fonction de vaultName. La deuxième commande obtient la date d’il y a sept jours, puis la stocke dans la variable $startDate. La troisième commande obtient la date d’aujourd’hui, puis la stocke dans la variable $endDate. La quatrième commande obtient des éléments de sauvegarde basés sur backupManagementType et workloadType, vaultId, puis les stocke dans la variable $item. La dernière commande obtient un tableau de points de récupération pour l’élément dans $backupItem qui sont prêts à être déplacés vers le niveau VaultArchive, puis les stocke dans la variable $rp.

Exemple 3 : Obtenir des points de récupération dans un niveau particulier

$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

La première commande obtient l’objet de coffre en fonction de vaultName. La deuxième commande obtient la date d’il y a sept jours, puis la stocke dans la variable $startDate. La troisième commande obtient la date d’aujourd’hui, puis la stocke dans la variable $endDate. La quatrième commande obtient des éléments de sauvegarde basés sur backupManagementType et workloadType, vaultId, puis les stocke dans la variable $item. La dernière commande obtient un tableau de points de récupération pour l’élément dans $backupItem qui sont prêts à être déplacés vers le niveau VaultArchive, puis les stocke dans la variable $rp.

Exemple 4 : Obtention de points de récupération élagués au cours de l’année dernière après la modification de l’opertaion de stratégie

$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

La première commande obtient l’objet de coffre en fonction de vaultName. La deuxième commande obtient la date d’un an auparavant, puis la stocke dans la variable $startDate. La troisième commande obtient la date d’aujourd’hui, puis la stocke dans la variable $endDate. La quatrième commande obtient des éléments de sauvegarde basés sur backupManagementType et workloadType, vaultId, puis les stocke dans la variable $item. La cinquième commande obtient un tableau de points de récupération pour l’élément dans $item qui sont présents avant l’opération de modification de stratégie au cours de la dernière année. Nous allons maintenant mettre à jour la stratégie. La sixième commande récupère la stratégie à mettre à jour, utilisée pour protéger l’élément de sauvegarde $item[0]. Les septième, huit et neuvième commandes désactivent la rétention annuelle et mensuelle dans la stratégie pour découper les anciens points de récupération. La dixième commande met enfin à jour la stratégie de rétention. La onzeème commande attend dans la même session PowerShell jusqu’à ce que les points de récupération soient supprimés et extrait les points de récupération dans la même plage de temps, après l’application des modifications de stratégie. La commande twelth prend un écart entre la liste des points de récupération avant et après la taille. La treizième commande lit les points de récupération, du diff, qui étaient présents avant et sont maintenant nettoyés. La dernière commande affiche la liste des points de récupération élagués.

Paramètres

-DefaultProfile

-EndDate

-IsReadyForMove

-Item

-KeyFileDownloadLocation

-RecoveryPointId

-StartDate

-TargetTier

-Tier

-UseSecondaryRegion

-VaultId

Entrées

ItemBase

String

Sorties

RecoveryPointBase

Liens associés

• Get-AzRecoveryServicesBackupContainer
• Get-AzRecoveryServicesBackupItem