Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este artigo descreve como usar o Azure PowerShell para fazer backup dos Arquivos do Azure por meio de um cofre dos Serviços de Recuperação de Backup do Azure .
Pré-requisitos
Antes de fazer backup dos Arquivos do Azure, verifique se os seguintes pré-requisitos são atendidos:
Saiba mais sobre cofres de Serviços de Recuperação.
Analise a referência do cmdlet Az.RecoveryServices na biblioteca Azure.
Analise a seguinte hierarquia de objetos do PowerShell para Serviços de Recuperação:
Configurar o PowerShell
Nota
Recomendamos que utilize o módulo Azure Az do PowerShell para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.
Nota
Atualmente, o Azure PowerShell não oferece suporte a políticas de backup com agendamento por hora. Use o portal do Azure para aplicar esse recurso. Mais informações
Configure o PowerShell da seguinte maneira:
Baixe a versão mais recente do Azure PowerShell.
Nota
A versão mínima do PowerShell necessária para o backup dos Arquivos do Azure é Az.RecoveryServices 2.6.0. A versão mais recente, ou pelo menos a versão mínima, ajuda a evitar problemas com scripts existentes. Instale a versão mínima usando o seguinte comando do PowerShell:
Install-module -Name Az.RecoveryServices -RequiredVersion 2.6.0Encontre os cmdlets do PowerShell para o Backup do Azure usando este comando:
Get-Command *azrecoveryservices*Analise os aliases e comandos do Backup do Azure, do Azure Site Recovery e do cofre dos Serviços de Recuperação. Aqui está um exemplo do que você pode ver. Não é uma lista completa de comandos cmdlet.
Entre na sua conta do Azure usando Connect-AzAccount.
Na página Web apresentada, ser-lhe-á pedido que introduza as credenciais da sua conta.
Como alternativa, você pode incluir suas credenciais de conta como um parâmetro no cmdlet Connect-AzAccount usando -Credential.
Se você for um parceiro CSP (Provedor de Serviços de Nuvem) trabalhando em nome de um locatário, especifique o cliente como locatário. Use seu ID de locatário ou nome de domínio principal do locatário. Um exemplo é Connect-AzAccount -Tenant "fabrikam.com".
Associe a subscrição que pretende utilizar à conta, porque uma conta pode ter várias subscrições:
Select-AzSubscription -SubscriptionName $SubscriptionNameSe você estiver usando o Backup do Azure pela primeira vez, use o cmdlet Register-AzResourceProvider para registrar o provedor de Serviços de Recuperação do Azure com sua assinatura:
Register-AzResourceProvider -ProviderNamespace "Microsoft.RecoveryServices"Verifique se os provedores se registraram com êxito:
Get-AzResourceProvider -ProviderNamespace "Microsoft.RecoveryServices"Na saída do comando, verifique se RegistrationState muda para Registered. Caso contrário, execute o cmdlet Register-AzResourceProvider novamente.
Criar um Cofre de Serviços de Recuperação
O cofre dos Serviços de Recuperação é um recurso do Gerenciador de Recursos, portanto, você deve colocá-lo em um grupo de recursos. Você pode usar um grupo de recursos existente ou criar um grupo de recursos usando o cmdlet New-AzResourceGroup . Ao criar um grupo de recursos, especifique o nome e o local para ele.
Siga estas etapas para criar um cofre de Serviços de Recuperação:
Crie um novo grupo de recursos usando o cmdlet New-AzResourceGroup , se você não tiver um existente. Neste exemplo, criamos um grupo de recursos na região Oeste dos EUA:
New-AzResourceGroup -Name "test-rg" -Location "West US"Utilize o cmdlet New-AzRecoveryServicesVault para criar o cofre. Especifique o mesmo local para o cofre que você usou para o grupo de recursos.
New-AzRecoveryServicesVault -Name "testvault" -ResourceGroupName "test-rg" -Location "West US"
Ver os cofres numa subscrição
Para exibir todos os cofres na assinatura, use Get-AzRecoveryServicesVault:
Get-AzRecoveryServicesVault
A saída é semelhante à seguinte. A saída fornece o grupo de recursos associado e a localização.
Name : Contoso-vault
ID : /subscriptions/1234
Type : Microsoft.RecoveryServices/vaults
Location : WestUS
ResourceGroupName : Contoso-docs-rg
SubscriptionId : 1234-567f-8910-abc
Properties : Microsoft.Azure.Commands.RecoveryServices.ARSVaultProperties
Definir o contexto do cofre
Armazene o objeto do vault em uma variável e defina o contexto do vault.
Muitos cmdlets do Backup do Azure exigem o objeto vault dos Serviços de Recuperação como entrada, por isso é conveniente armazenar o objeto vault em uma variável.
O contexto do cofre é o tipo de dados protegidos no cofre. Defina-o usando Set-AzRecoveryServicesVaultContext. Depois que o contexto está configurado, ele se aplica a todos os cmdlets subsequentes.
O exemplo a seguir define o contexto do vault para testvault:
Get-AzRecoveryServicesVault -Name "testvault" | Set-AzRecoveryServicesVaultContext
Buscar o ID do cofre
Planeamos descontinuar a configuração de contexto do Vault de acordo com as diretrizes do Azure PowerShell. Em vez disso, você pode armazenar ou buscar o ID do cofre e passá-lo para comandos relevantes. Se não definiu o contexto do cofre ou desejar especificar o comando a ser executado para um determinado cofre, passe o ID do cofre como -vaultID para todos os comandos relevantes da seguinte maneira:
$vaultID = Get-AzRecoveryServicesVault -ResourceGroupName "Contoso-docs-rg" -Name "testvault" | select -ExpandProperty ID
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewAFSPolicy" -WorkloadType "AzureFiles" -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultID $vaultID
Configurar uma política de backup
Uma política de backup especifica o agendamento de backups e por quanto tempo os pontos de recuperação de backup devem ser mantidos.
Uma política de backup está associada a pelo menos uma política de retenção. Uma política de retenção define por quanto tempo um ponto de recuperação é mantido. Você pode configurar backups com retenção diária, semanal, mensal ou anual. Com a política de múltiplos backups, pode-se também configurar a retenção de backups por hora.
Importante
Os seguintes cmdlets são usados para as políticas de backup:
- Exiba a política de retenção de backup padrão usando
Get-AzRecoveryServicesBackupRetentionPolicyObject. - Exiba a política padrão de agendamento de backups usando
Get-AzRecoveryServicesBackupSchedulePolicyObject. - Crie uma nova política de backup usando
New-AzRecoveryServicesBackupProtectionPolicy. Forneça os objetos de cronograma e política de retenção como entradas.
Escolha uma camada de backup:
Para criar uma política de backup que configure vários backups por dia para o backup de instantâneo dos Arquivos do Azure, execute os seguintes cmdlets:
Buscar o objeto de política de agendamento.
$schPol=Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly $schPolExemplo de saída:
ScheduleRunFrequency : Hourly ScheduleRunDays : ScheduleRunTimes : ScheduleInterval : 8 ScheduleWindowStartTime : 12/22/2021 8:00:00 AM ScheduleWindowDuration : 16 ScheduleRunTimeZone : India Standard TimeDefina os diferentes parâmetros do cronograma conforme necessário.
$schpol.ScheduleInterval=4 $schpol.ScheduleWindowDuration=12A configuração anterior ajuda você a agendar 4 backups por dia em uma janela das 8h às 20h (8h + 12 horas). Você também pode definir o fuso horário conforme mencionado no cmdlet a seguir:
$timeZone= $timeZone=Get-TimeZone -ListAvailable |Where-Object{$_.Id-match "Russia Time Zone 11"} $schPol.ScheduleRunTimeZone=$timeZone.IdPara criar uma política com agenda diária, execute o seguinte cmdlet:
$UtcTime = Get-Date -Date "2019-03-20 01:30:00Z" $UtcTime = $UtcTime.ToUniversalTime() $schpol.ScheduleRunTimes[0] = $UtcTimeBuscar o objeto de política de retenção usando o seguinte cmdlet:
$retPol=Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency HourlyDefina os valores de retenção conforme necessário.
$retPol.DailySchedule.DurationCountInDays=15Crie uma nova política de backup usando New-AzRecoveryServicesBackupProtectionPolicy.
Você pode passar os objetos de agenda e política de retenção definidos anteriormente como entradas.
New-AzRecoveryServicesBackupProtectionPolicy -Name "FilesPolicytesting" -WorkloadType AzureFiles -RetentionPolicy $retpol -SchedulePolicy $schpolA saída exibe a configuração da política:
Name WorkloadType BackupManagementType ScheduleFrequency BackupTime WindowStartTime Interval WindowDuration TimeZone (UTC) (Hours) ---- ------------ -------------------- ----------------- ------------ --------------- -------- -------------- -------- FilesPolicy testing AzureFiles AzureStorage Hourly 12/22/2021 8:00:00 AM 4 12 Russia Time Zone 11
Habilitar o backup
Depois de definir a política de backup, você pode habilitar a proteção para os Arquivos do Azure usando a política.
Recuperar uma política de backup
Você busca o objeto de política relevante usando Get-AzRecoveryServicesBackupProtectionPolicy. Use este cmdlet para exibir as políticas associadas a um tipo de carga de trabalho ou para obter uma política específica.
Recuperar uma política para um tipo de carga de trabalho
O exemplo a seguir recupera políticas para o tipo de carga de trabalho AzureFiles:
Get-AzRecoveryServicesBackupProtectionPolicy -WorkloadType "AzureFiles"
Exemplo de saída:
Name WorkloadType BackupManagementType BackupTime DaysOfWeek
---- ------------ -------------------- ---------- ----------
dailyafs AzureFiles AzureStorage 1/10/2018 12:30:00 AM
Nota
O fuso horário do campo BackupTime no PowerShell está em UTC. Quando a hora de backup é mostrada no portal do Azure, a hora é ajustada ao seu fuso horário local.
Recuperar uma política específica
A política a seguir recupera a política de backup chamada dailyafs:
$afsPol = Get-AzRecoveryServicesBackupProtectionPolicy -Name "dailyafs"
Habilitar a proteção e aplicar a política
Habilite a proteção usando Enable-AzRecoveryServicesBackupProtection. Depois que a política é associada ao cofre, os backups são acionados de acordo com o cronograma da política.
O exemplo a seguir habilita a proteção para os Arquivos do Azure testAzureFS na conta de armazenamento testStorageAcct, com a política dailyafs:
Enable-AzRecoveryServicesBackupProtection -StorageAccountName "testStorageAcct" -Name "testAzureFS" -Policy $afsPol
O comando aguarda até que o trabalho de proteção de configuração seja concluído e fornece uma saída semelhante ao exemplo a seguir:
WorkloadName Operation Status StartTime EndTime JobID
------------ --------- ------ --------- ------- -----
testAzureFS ConfigureBackup Completed 11/12/2018 2:15:26 PM 11/12/2018 2:16:11 PM ec7d4f1d-40bd-46a4-9edb-3193c41f6bf6
Para obter mais informações sobre como obter uma lista de compartilhamentos de arquivos para uma conta de armazenamento, consulte este artigo.
Aviso importante: Identificação do item de backup
Esta seção descreve uma alteração importante nos backups dos Arquivos do Azure em preparação para a disponibilidade geral.
Quando você habilita um backup para Arquivos do Azure, o usuário obtém um nome de compartilhamento de arquivos como o nome da entidade e um item de backup é criado. O nome do item de backup é um identificador exclusivo que o serviço de Backup do Azure cria. Normalmente, o identificador é um nome de fácil utilização. Para lidar com cenários de exclusão flexível, em que um Compartilhamento de Arquivos é excluído e um novo com o mesmo nome é criado, os Arquivos do Azure agora usam uma ID exclusiva.
Para saber a ID exclusiva de cada item, execute o comando Get-AzRecoveryServicesBackupItem com os filtros relevantes para backupManagementType e WorkloadType para obter todos os itens relevantes. Em seguida, observe o campo de nome no objeto/resposta do PowerShell retornado.
Recomendamos listar os itens e, em seguida, recuperar o seu nome único a partir do campo de nome na resposta. Use esse valor para filtrar os itens com o parâmetro Name . Caso contrário, use o parâmetro FriendlyName para recuperar o item com sua ID.
Importante
Verifique se o PowerShell foi atualizado para a versão mínima (Az.RecoveryServices 2.6.0) para backups dos Arquivos do Azure. Com esta versão, o filtro FriendlyName está disponível para o comando Get-AzRecoveryServicesBackupItem .
Passe o nome do Azure Files para o parâmetro FriendlyName. Se você passar o nome do compartilhamento de arquivos para o parâmetro Name , esta versão lançará um aviso para passar o nome para o parâmetro FriendlyName .
Não instalar a versão mínima pode resultar em uma falha de scripts existentes. Instale a versão mínima do PowerShell usando o seguinte comando:
Install-module -Name Az.RecoveryServices -RequiredVersion 2.6.0
Acionar um backup sob demanda
Para executar um backup sob demanda para um Arquivo do Azure protegido, use o cmdlet Backup-AzRecoveryServicesBackupItem :
- Recupere a conta de armazenamento do contêiner no cofre que contém seus dados de backup usando Get-AzRecoveryServicesBackupContainer.
- Inicie um trabalho de backup, obtenha informações sobre os Arquivos do Azure usando Get-AzRecoveryServicesBackupItem.
- Execute um backup sob demanda usando Backup-AzRecoveryServicesBackupItem.
Execute o backup sob demanda da seguinte maneira:
$afsContainer = Get-AzRecoveryServicesBackupContainer -FriendlyName "testStorageAcct" -ContainerType AzureStorage
$afsBkpItem = Get-AzRecoveryServicesBackupItem -Container $afsContainer -WorkloadType "AzureFiles" -FriendlyName "testAzureFS"
$job = Backup-AzRecoveryServicesBackupItem -Item $afsBkpItem
O comando retorna um trabalho com uma ID a ser rastreada, conforme mostrado no exemplo a seguir:
WorkloadName Operation Status StartTime EndTime JobID
------------ --------- ------ --------- ------- -----
testAzureFS Backup Completed 11/12/2018 2:42:07 PM 11/12/2018 2:42:11 PM 8bdfe3ab-9bf7-4be6-83d6-37ff1ca13ab6
Os instantâneos dos Arquivos do Azure são usados enquanto os backups são feitos. Normalmente, o trabalho termina no momento em que o comando retorna essa saída.
Próximos passos
- Restaure os Arquivos do Azure usando o Azure PowerShell.
- Restaure os Arquivos do Azure usando o portal do Azure, CLI do Azure, API REST.
- Gerencie backups de Arquivos do Azure usando o portal do Azure, Azure PowerShell, CLI do Azure, API REST.
- Script de exemplo no GitHub para usar um runbook do Azure Automation para agendar cópias de segurança.