Get-AzRecoveryServicesBackupRecoveryPoint
Obtém os pontos de recuperação de 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
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 no vaultName. O segundo comando obtém a data de sete dias atrás e, em seguida, a armazena na variável $startDate. O terceiro comando obtém a data de hoje e, em seguida, a armazena 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, o armazena na variável $backupItem. O último comando obtém uma matriz de pontos de recuperação para o item em $BackupItem e os armazena na variável $rp.
Exemplo 2: Obter pontos de recuperação que estão prontos para serem movidos para 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 no vaultName. O segundo comando obtém a data de sete dias atrás e, em seguida, a armazena na variável $startDate. O terceiro comando obtém a data de hoje e, em seguida, a armazena na variável $endDate. O quarto comando obtém itens de backup com base em backupManagementType e workloadType, vaultId e, em seguida, armazena-o 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, os armazena 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 no vaultName. O segundo comando obtém a data de sete dias atrás e, em seguida, a armazena na variável $startDate. O terceiro comando obtém a data de hoje e, em seguida, a armazena na variável $endDate. O quarto comando obtém itens de backup com base em backupManagementType e workloadType, vaultId e, em seguida, armazena-o 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, os armazena na variável $rp.
Exemplo 4: Obtendo pontos de recuperação podados no ano passado após modificar a opertaion da 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 no 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, a armazena na variável $endDate. O quarto comando obtém itens de backup com base em backupManagementType e workloadType, vaultId e, em seguida, armazena-o 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 modificação de política 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]. O sétimo, oito e nono comandos desabilitam a retenção anual e mensal na política para podar 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 décimo segundo comando assume uma diferença entre a lista de pontos de recuperação antes e depois da poda. O décimo terceiro comando leu os pontos de recuperação, da diferença, que estavam presentes antes e agora são podados. O último comando exibe a lista de pontos de recuperação podados.
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 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EndDate
Especifica o final do intervalo de datas.
Tipo: | Nullable<T>[DateTime] |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IsReadyForMove
Filtra os Pontos de Recuperação com base em se RP está pronto para mover para a camada de destino. Use isso junto com o parâmetro da camada de destino.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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 |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-KeyFileDownloadLocation
Especifica o local para baixar o arquivo de entrada para restaurar a chave KeyVault para uma máquina virtual criptografada.
Tipo: | String |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RecoveryPointId
Especifica a ID do ponto de recuperação.
Tipo: | String |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-StartDate
Especifica o início do intervalo de datas.
Tipo: | Nullable<T>[DateTime] |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-TargetTier
Camada de destino para verificar a preparação de movimentação do ponto de recuperação. Atualmente, apenas o valor válido é 'VaultArchive'.
Tipo: | RecoveryPointTier |
Valores aceitos: | VaultArchive |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Tier
Filtrar pontos de recuperação com base no valor da camada.
Tipo: | RecoveryPointTier |
Valores aceitos: | VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UseSecondaryRegion
Filtros da região secundária para restauração entre regiões
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-VaultId
ID do ARM do Cofre dos Serviços de Recuperação.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Entradas
Saídas
Links Relacionados
Azure PowerShell