Gerenciar os backups de compartilhamento de arquivos do Azure com o PowerShell

  • Artigo

Este artigo descreve como usar o Azure PowerShell para gerenciar e monitorar os compartilhamentos de arquivos do Azure cujo backup é feito pelo Serviço de Backup do Azure.

Aviso

Não deixe de verificar se a versão do PowerShell está atualizada para a versão mínima do “AZ.RecoveryServices 2.6.0” para backups do AFS. Para obter mais detalhes,veja a seção que descreve o requisito para essa alteração.

Modificar a política de proteção

Para alterar a política usada para fazer backup do compartilhamento de arquivos do Azure, use Enable-AzRecoveryServicesBackupProtection. Especifique o item de backup relevante e a nova política de backup.

O exemplo a seguir altera a política de proteção de testAzureFS de dailyafs para monthlyafs.

$monthlyafsPol =  Get-AzRecoveryServicesBackupProtectionPolicy -Name "monthlyafs"
$afsContainer = Get-AzRecoveryServicesBackupContainer -FriendlyName "testStorageAcct" -ContainerType AzureStorage
$afsBkpItem = Get-AzRecoveryServicesBackupItem -Container $afsContainer -WorkloadType AzureFiles -Name "testAzureFS"
Enable-AzRecoveryServicesBackupProtection -Item $afsBkpItem -Policy $monthlyafsPol

Acompanhar tarefas de backup e restauração

As operações de backup e restauração sob demanda retornam um trabalho com uma ID, conforme mostrado ao executar um backup sob demanda. Use o cmdlet Get-AzRecoveryServicesBackupJobDetails para acompanhar o progresso do trabalho e outros detalhes.

$job = Get-AzRecoveryServicesBackupJob -JobId 00000000-6c46-496e-980a-3740ccb2ad75 -VaultId $vaultID

 $job | fl


IsCancellable        : False
IsRetriable          : False
ErrorDetails         : {Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.AzureFileShareJobErrorInfo}
ActivityId           : 00000000-5b71-4d73-9465-8a4a91f13a36
JobId                : 00000000-6c46-496e-980a-3740ccb2ad75
Operation            : Restore
Status               : Failed
WorkloadName         : testAFS
StartTime            : 12/10/2018 9:56:38 AM
EndTime              : 12/10/2018 11:03:03 AM
Duration             : 01:06:24.4660027
BackupManagementType : AzureStorage

$job.ErrorDetails

 ErrorCode ErrorMessage                                          Recommendations
 --------- ------------                                          ---------------
1073871825 Microsoft Azure Backup encountered an internal error. Wait for a few minutes and then try the operation again. If the issue persists, please contact Microsoft support.

Interromper a proteção em um compartilhamento de arquivo

Há duas maneiras de interromper a proteção de compartilhamentos de arquivos do Azure:

  • Interromper todos os trabalhos de backup futuros e excluir todos os pontos de recuperação
  • Interromper todos os trabalhos de backup futuros, mas deixar os pontos de recuperação

Pode haver um custo associado ao deixar os pontos de recuperação no armazenamento, uma vez que os instantâneos subjacentes criados pelo Backup do Azure serão retidos. No entanto, a vantagem de deixar os pontos de recuperação é que você pode restaurar o compartilhamento de arquivos mais tarde, se desejado. Para obter informações sobre o custo de deixar os pontos de recuperação, confira os detalhes de preços. Caso opte por excluir todos os pontos de recuperação, não poderá restaurar o compartilhamento de arquivos.

Interromper a proteção e manter os pontos de recuperação

Para interromper a proteção retendo os dados, use o cmdlet Disable-AzRecoveryServicesBackupProtection.

O exemplo a seguir interrompe a proteção para o compartilhamento de arquivos afsfileshare, mas retém todos os pontos de recuperação:

$vaultID = Get-AzRecoveryServicesVault -ResourceGroupName "afstesting" -Name "afstest" | select -ExpandProperty ID
$bkpItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureStorage -WorkloadType AzureFiles -Name "afsfileshare" -VaultId $vaultID
Disable-AzRecoveryServicesBackupProtection -Item $bkpItem -VaultId $vaultID

WorkloadName     Operation         Status         StartTime                 EndTime                   JobID
------------     ---------         ------         ---------                 -------                   -----
afsfileshare     DisableBackup     Completed      1/26/2020 2:43:59 PM      1/26/2020 2:44:21 PM      98d9f8a1-54f2-4d85-8433-c32eafbd793f

O atributo ID do Trabalho na saída corresponde à ID do Trabalho que é criado pelo serviço de backup para a operação “interromper proteção”. Para monitorar o status de um trabalho, use o cmdlet Get-AzRecoveryServicesBackupJob.

Interromper a proteção sem reter pontos de recuperação

Para interromper a proteção sem reter pontos de recuperação, use o cmdlet Disable-AzRecoveryServicesBackupProtection e adicione o parâmetro -RemoveRecoveryPoints.

O exemplo a seguir interrompe a proteção para o compartilhamento de arquivos afsfileshare sem reter os pontos de recuperação:

$vaultID = Get-AzRecoveryServicesVault -ResourceGroupName "afstesting" -Name "afstest" | select -ExpandProperty ID
$bkpItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureStorage -WorkloadType AzureFiles -Name "afsfileshare" -VaultId $vaultID
Disable-AzRecoveryServicesBackupProtection -Item $bkpItem -VaultId $vaultID -RemoveRecoveryPoints

WorkloadName     Operation            Status         StartTime                 EndTime                   JobID
------------     ---------            ------         ---------                 -------                   -----
afsfileshare     DeleteBackupData     Completed      1/26/2020 2:50:57 PM      1/26/2020 2:51:39 PM      b1a61c0b-548a-4687-9d15-9db1cc5bcc85

Próximas etapas

Saiba como gerenciar backups de compartilhamento de arquivos do Azure no portal do Azure.