Get-AzRecoveryServicesBackupRecoveryPoint
Obtient les points de récupération d’un élément sauvegardé.
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
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.IDLa 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 VaultArchiveLa 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 VaultStandardLa 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 AzureVMLa 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
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
Spécifie la fin de la plage de dates.
| Type: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsReadyForMove
Filtre les points de récupération en fonction du fait que le fournisseur de ressources est prêt à passer au niveau cible. Utilisez-le avec le paramètre de niveau cible.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Item
Spécifie l’élément pour lequel cette applet de commande obtient des points de récupération. Pour obtenir un objet AzureRmRecoveryServicesBackupItem , utilisez l’applet de commande Get-AzRecoveryServicesBackupItem .
| Type: | ItemBase |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFileDownloadLocation
Spécifie l’emplacement où télécharger le fichier d’entrée pour restaurer la clé KeyVault pour une machine virtuelle chiffrée.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecoveryPointId
Spécifie l’ID du point de récupération.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
Spécifie le début de la plage de dates.
| Type: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetTier
Niveau cible pour case activée la préparation du déplacement du point de récupération. Actuellement, seule la valeur valide est « VaultArchive ».
| Type: | RecoveryPointTier |
| Accepted values: | VaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tier
Filtrez les points de récupération en fonction de la valeur de niveau.
| 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
Filtres de la région secondaire pour la restauration interrégion
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
ID ARM du coffre Recovery Services.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |