Compartir a través de


Get-AzRecoveryServicesBackupRecoveryPoint

Obtiene los puntos de recuperación de un elemento de copia de seguridad.

Sintaxis

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

El cmdlet Get-AzRecoveryServicesBackupRecoveryPoint obtiene los puntos de recuperación de un elemento de Azure Backup de copia de seguridad. Una vez realizado una copia de seguridad de un elemento, un objeto AzureRmRecoveryServicesBackupRecoveryPoint tiene uno o varios puntos de recuperación. Establezca el contexto del almacén mediante el parámetro -VaultId.

Ejemplos

Ejemplo 1: Obtener puntos de recuperación de la última semana para un elemento

$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

El primer comando obtiene el objeto de almacén basado en vaultName. El segundo comando obtiene la fecha de hace siete días y, a continuación, la almacena en la variable $startDate. El tercer comando obtiene la fecha de hoy y, a continuación, la almacena en la variable $endDate. El cuarto comando obtiene contenedores de copia de seguridad de AzureVM y los almacena en la variable $Container. El quinto comando obtiene el elemento de copia de seguridad basado en workloadType, vaultId y, a continuación, lo almacena en la variable $backupItem. El último comando obtiene una matriz de puntos de recuperación para el elemento en $BackupItem y, a continuación, los almacena en la variable $rp.

Ejemplo 2: Obtener puntos de recuperación que están listos para moverse a 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

El primer comando obtiene el objeto de almacén basado en vaultName. El segundo comando obtiene la fecha de hace siete días y, a continuación, la almacena en la variable $startDate. El tercer comando obtiene la fecha de hoy y, a continuación, la almacena en la variable $endDate. El cuarto comando obtiene elementos de copia de seguridad basados en backupManagementType y workloadType, vaultId y, a continuación, los almacena en la variable $item. El último comando obtiene una matriz de puntos de recuperación para el elemento de $backupItem que están listos para moverse al nivel VaultArchive y, a continuación, los almacena en la variable $rp.

Ejemplo 3: Obtención de puntos de recuperación en un nivel determinado

$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

El primer comando obtiene el objeto de almacén basado en vaultName. El segundo comando obtiene la fecha de hace siete días y, a continuación, la almacena en la variable $startDate. El tercer comando obtiene la fecha de hoy y, a continuación, la almacena en la variable $endDate. El cuarto comando obtiene elementos de copia de seguridad basados en backupManagementType y workloadType, vaultId y, a continuación, los almacena en la variable $item. El último comando obtiene una matriz de puntos de recuperación para el elemento de $backupItem que están listos para moverse al nivel VaultArchive y, a continuación, los almacena en la variable $rp.

Ejemplo 4: Obtención de puntos de recuperación podados en el año pasado después de modificar la opertación de directivas

$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

El primer comando obtiene el objeto de almacén basado en vaultName. El segundo comando obtiene la fecha de hace un año y, a continuación, la almacena en la variable $startDate. El tercer comando obtiene la fecha de hoy y, a continuación, la almacena en la variable $endDate. El cuarto comando obtiene elementos de copia de seguridad basados en backupManagementType y workloadType, vaultId y, a continuación, los almacena en la variable $item. El quinto comando obtiene una matriz de puntos de recuperación para el elemento de $item que están presentes antes de la operación modificar directiva en el último año. Ahora vamos a actualizar la directiva. El sexto comando captura la directiva que se va a actualizar, que se usa para proteger el elemento de copia de seguridad $item[0]. Los séptimos, ocho y novenos comandos deshabilitan la retención anual y mensual en la directiva para eliminar los puntos de recuperación más antiguos. El décimo comando actualiza finalmente la directiva de retención. El undécimo comando espera en la misma sesión de PowerShell hasta que se eliminan los puntos de recuperación y captura los puntos de recuperación dentro del mismo intervalo de tiempo, después de aplicar los cambios de directiva. El comando twelth toma una diferencia entre la lista de puntos de recuperación antes y después de la eliminación. El decimotercer comando leyó los puntos de recuperación, de la diferencia, que estaban presentes antes y ahora están eliminados. El último comando muestra la lista de puntos de recuperación podados.

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EndDate

Especifica el final del intervalo de fechas.

Tipo:Nullable<T>[DateTime]
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsReadyForMove

Filtra los puntos de recuperación en función de si RP está listo para pasar al nivel de destino. Úselo junto con el parámetro de nivel de destino.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Item

Especifica el elemento para el que este cmdlet obtiene puntos de recuperación. Para obtener un objeto AzureRmRecoveryServicesBackupItem , use el cmdlet Get-AzRecoveryServicesBackupItem .

Tipo:ItemBase
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-KeyFileDownloadLocation

Especifica la ubicación para descargar el archivo de entrada para restaurar la clave keyVault de una máquina virtual cifrada.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RecoveryPointId

Especifica el identificador del punto de recuperación.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StartDate

Especifica el inicio del intervalo de fechas.

Tipo:Nullable<T>[DateTime]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TargetTier

Nivel de destino para comprobar la preparación del traslado del punto de recuperación. Actualmente, solo el valor válido es "VaultArchive".

Tipo:RecoveryPointTier
Valores aceptados:VaultArchive
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tier

Filtre los puntos de recuperación en función del valor del nivel.

Tipo:RecoveryPointTier
Valores aceptados:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UseSecondaryRegion

Filtros de la región secundaria para la restauración entre regiones

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VaultId

Id. de ARM del almacén de Recovery Services.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

ItemBase

String

Salidas

RecoveryPointBase