Partilhar via

Get-AzRecoveryServicesBackupRecoveryPoint

  • Referência
Módulo:
Az.RecoveryServices

Obtém os pontos de recuperação para um item de backup.

Sintaxe

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

O cmdlet Get-AzRecoveryServicesBackupRecoveryPoint obtém os pontos de recuperação para um item de backup do Backup do Azure. Após o backup de um item, um objeto AzureRmRecoveryServicesBackupRecoveryPoint tem um ou mais pontos de recuperação. Defina o contexto do vault usando o parâmetro -VaultId.

Exemplos

Exemplo 1: Obter pontos de recuperação da última semana para um item

$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

O primeiro comando obtém o objeto vault com base em vaultName. O segundo comando obtém a data de sete dias atrás e, em seguida, armazena-a na variável $startDate. O terceiro comando obtém a data de hoje e, em seguida, armazena-a na variável $endDate. O quarto comando obtém contêineres de backup do AzureVM e os armazena na variável $Container. O quinto comando obtém o item de backup com base em workloadType, vaultId e, em seguida, armazena-o na variável $backupItem. O último comando obtém uma matriz de pontos de recuperação para o item em $BackupItem e, em seguida, armazena-os na variável $rp.

Exemplo 2: Obter pontos de recuperação que estão prontos para serem movidos para o 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

O primeiro comando obtém o objeto vault com base em vaultName. O segundo comando obtém a data de sete dias atrás e, em seguida, armazena-a na variável $startDate. O terceiro comando obtém a data de hoje e, em seguida, armazena-a na variável $endDate. O quarto comando obtém itens de backup com base em backupManagementType e workloadType, vaultId e, em seguida, armazena-os na variável $item. O último comando obtém uma matriz de pontos de recuperação para o item em $backupItem que estão prontos para serem movidos para a camada VaultArchive e, em seguida, armazena-os na variável $rp.

Exemplo 3: Obter pontos de recuperação em uma camada específica

$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

O primeiro comando obtém o objeto vault com base em vaultName. O segundo comando obtém a data de sete dias atrás e, em seguida, armazena-a na variável $startDate. O terceiro comando obtém a data de hoje e, em seguida, armazena-a na variável $endDate. O quarto comando obtém itens de backup com base em backupManagementType e workloadType, vaultId e, em seguida, armazena-os na variável $item. O último comando obtém uma matriz de pontos de recuperação para o item em $backupItem que estão prontos para serem movidos para a camada VaultArchive e, em seguida, armazena-os na variável $rp.

Exemplo 4: Obter pontos de recuperação removidos no ano passado após modificar a operação de política

$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

O primeiro comando obtém o objeto vault com base em vaultName. O segundo comando obtém a data de um ano atrás e, em seguida, armazena-a na variável $startDate. O terceiro comando obtém a data de hoje e, em seguida, armazena-a na variável $endDate. O quarto comando obtém itens de backup com base em backupManagementType e workloadType, vaultId e, em seguida, armazena-os na variável $item. O quinto comando obtém uma matriz de pontos de recuperação para o item em $item que estão presentes antes da operação de política de modificação no último ano. Agora passamos a atualizar a política. O sexto comando busca a política a ser atualizada, que é usada para proteger o item de backup $item[0]. Os sétimo, oitavo e nono comandos desativam a retenção anual e mensal na política para eliminar os pontos de recuperação mais antigos. O décimo comando finalmente atualiza a política de retenção. O décimo primeiro comando aguarda na mesma sessão do powershell até que os pontos de recuperação sejam removidos e busque os pontos de recuperação dentro do mesmo intervalo de tempo, depois que as alterações de política forem aplicadas. O comando twelth faz uma diferença entre a lista de pontos de recuperação antes e depois da remoção ocorrer. O décimo terceiro comando leu os pontos de recuperação, a partir do diff, que estavam presentes antes e agora estão podados. O último comando exibe a lista de pontos de recuperação removidos.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EndDate

Especifica o final do intervalo de datas.

Tipo:Nullable<T>[DateTime]
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsReadyForMove

Filtra os Pontos de Recuperação com base em se o RP está Pronto para mover para a camada de destino. Use isso junto com o parâmetro da camada de destino.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Item

Especifica o item para o qual esse cmdlet obtém pontos de recuperação. Para obter um objeto AzureRmRecoveryServicesBackupItem, use o cmdlet Get-AzRecoveryServicesBackupItem.

Tipo:ItemBase
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-KeyFileDownloadLocation

Especifica o local para baixar o arquivo de entrada para restaurar a chave KeyVault para uma máquina virtual criptografada.

Tipo:String
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RecoveryPointId

Especifica a ID do ponto de recuperação.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StartDate

Especifica o início do intervalo de datas.

Tipo:Nullable<T>[DateTime]
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TargetTier

Camada de destino para verificar a prontidão de movimentação do ponto de recuperação. Atualmente, apenas o valor válido é 'VaultArchive'.

Tipo:RecoveryPointTier
Valores aceites:VaultArchive
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tier

Filtre os pontos de recuperação com base no valor da camada.

Tipo:RecoveryPointTier
Valores aceites:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UseSecondaryRegion

Filtros da região secundária para restauração entre regiões

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VaultId

ID ARM do Cofre dos Serviços de Recuperação.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

ItemBase

String

Saídas

RecoveryPointBase