Get-AzRecoveryServicesBackupRecoveryPoint
Obtém os pontos de recuperação para um item de backup.
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
O cmdlet Get-AzRecoveryServicesBackupRecoveryPoint obtém os pontos de recuperação para um item de Backup do Azure com backup. 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.IDO 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 o armazena 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 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 VaultArchiveO 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, 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 VaultStandardO 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, os armazena na variável $rp.
Exemplo 4: Obtendo pontos de recuperação removidos no ano passado após modificar a operação 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 AzureVMO 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 modificação de diretiva 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, oito e nono comandos desabilitam a retenção anual e mensal na política para remover 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, do diff, que estavam presentes antes e agora sã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.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
Especifica o final do intervalo de datas.
| Type: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | ItemBase |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFileDownloadLocation
Especifica o local para baixar o arquivo de entrada para restaurar a chave KeyVault para uma máquina virtual criptografada.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecoveryPointId
Especifica a ID do ponto de recuperação.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
Especifica o início do intervalo de datas.
| Type: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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'.
| Type: | RecoveryPointTier |
| Accepted values: | VaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tier
Filtre os pontos de recuperação com base no valor da camada.
| 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
Filtros da região secundária para restauração entre regiões
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
ID do ARM do Cofre de Serviços de Recuperação.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entradas
Saídas
Links Relacionados
Azure PowerShell
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de