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.IDEl 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 VaultArchiveEl 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 VaultStandardEl 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 AzureVMEl 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 |
