Restaurar partilhas de ficheiros do Azure com a CLI do Azure

A CLI do Azure fornece uma experiência de linha de comandos para gerir recursos do Azure. É uma excelente ferramenta para criar automatização personalizada para utilizar recursos do Azure. Este artigo explica como restaurar uma partilha de ficheiros inteira ou ficheiros específicos a partir de um ponto de restauro criado por Azure Backup com a CLI do Azure. Também pode realizar estes passos com o Azure PowerShell ou no portal do Azure.

No final deste artigo, irá aprender a realizar as seguintes operações com a CLI do Azure:

• Ver pontos de restauro para uma partilha de ficheiros do Azure com cópia de segurança.
• Restaurar uma partilha de ficheiros do Azure completa.
• Restaurar ficheiros ou pastas individuais.

Nota

Azure Backup agora suporta o restauro de vários ficheiros ou pastas para a localização original ou alternativa com a CLI do Azure. Veja a secção Restaurar vários ficheiros ou pastas para a localização original ou alternativa deste documento para saber mais.

Pré-requisitos

Este artigo pressupõe que já tem uma partilha de ficheiros do Azure que é efetuada uma cópia de segurança por Azure Backup. Se não tiver uma, consulte Criar cópias de segurança de partilhas de ficheiros do Azure com a CLI para configurar a cópia de segurança da partilha de ficheiros. Para este artigo, utilize os seguintes recursos:

Partilha de ficheiros	Conta de armazenamento	Região	Detalhes
azurefiles	afsaccount	EastUS	Origem original efetuada uma cópia de segurança com Azure Backup
azurefiles1	afaccount1	EastUS	Origem de destino utilizada para recuperação de localização alternativa

Pode utilizar uma estrutura semelhante para as partilhas de ficheiros para experimentar os diferentes tipos de restauros explicados neste artigo.

Prepare o seu ambiente para o CLI do Azure

• Utilize o ambiente bash no Azure Cloud Shell. Para obter mais informações, veja Início Rápido do Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, veja Como executar a CLI do Azure num contentor do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de início de sessão, veja Iniciar sessão com a CLI do Azure.

  • Quando lhe for pedido, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

• Este tutorial requer a versão 2.0.18 ou posterior da CLI do Azure. Se utilizar o Azure Cloud Shell, a versão mais recente já está instalada.

Obter pontos de recuperação para a partilha de ficheiros do Azure

Utilize o cmdlet az backup recoverypoint list para listar todos os pontos de recuperação da partilha de ficheiros com cópia de segurança.

O exemplo seguinte obtém a lista de pontos de recuperação para a partilha de ficheiros azurefiles na conta de armazenamento afsaccount .

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --backup-management-type azurestorage --item-name "AzureFileShare;azurefiles" --workload-type azurefileshare --out table

Também pode executar o cmdlet anterior com o nome amigável do contentor e do item ao fornecer os seguintes dois parâmetros adicionais:

• --backup-management-type: azurestorage
• --workload-type: azurefileshare

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --item-name azurefiles --workload-type azurefileshare --out table

O conjunto de resultados é uma lista de pontos de recuperação com detalhes de tempo e consistência para cada ponto de restauro.

Name                Time                        Consistency
------------------  -------------------------   --------------------
932887541532871865  2020-01-05T07:08:23+00:00   FileSystemConsistent
932885927361238054  2020-01-05T07:08:10+00:00   FileSystemConsistent
932879614553967772  2020-01-04T21:33:04+00:00   FileSystemConsistent

O atributo Nome na saída corresponde ao nome do ponto de recuperação que pode ser utilizado como um valor para o parâmetro --rp-name nas operações de recuperação.

Recuperação de partilha completa com a CLI do Azure

Pode utilizar esta opção de restauro para restaurar a partilha de ficheiros completa na localização original ou alternativa.

Defina os seguintes parâmetros para realizar operações de restauro:

• --container-name: o nome da conta de armazenamento que aloja a partilha de ficheiros original de cópia de segurança. Para obter o nome ou o nome amigável do contentor, utilize o comando az backup container list .
• --item-name: o nome da partilha de ficheiros original de cópia de segurança que pretende utilizar para a operação de restauro. Para obter o nome ou o nome amigável do item de cópia de segurança, utilize o comando az backup item list .

Restaurar uma partilha completa para a localização original

Quando restaura para uma localização original, não precisa de especificar parâmetros relacionados com o destino. Só tem de ser fornecida a opção Resolver Conflito .

O exemplo seguinte utiliza o cmdlet az backup restore-azurefileshare com o modo de restauro definido como originallocation para restaurar a partilha de ficheiros azurefiles na localização original. Utilize o ponto de recuperação 932883129628959823, que obteve em Obter pontos de recuperação para a partilha de ficheiros do Azure:

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932887541532871865   --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
6a27cc23-9283-4310-9c27-dcfb81b7b4bb  azurefiles

O atributo Nome na saída corresponde ao nome da tarefa criada pelo serviço de cópia de segurança para a operação de restauro. Para controlar o estado da tarefa, utilize o cmdlet az backup job show .

Restaurar uma partilha completa para uma localização alternativa

Pode utilizar esta opção para restaurar uma partilha de ficheiros para uma localização alternativa e manter a partilha de ficheiros original tal como está. Especifique os seguintes parâmetros para a recuperação de localização alternativa:

• --target-storage-account: a conta de armazenamento para a qual o conteúdo da cópia de segurança é restaurado. A conta de armazenamento de destino tem de estar na mesma localização que o cofre.
• --target-file-share: a partilha de ficheiros na conta de armazenamento de destino para a qual o conteúdo da cópia de segurança é restaurado.
• --target-folder: a pasta na partilha de ficheiros à qual os dados são restaurados. Se o conteúdo de cópia de segurança for restaurado para uma pasta raiz, atribua os valores da pasta de destino como uma cadeia vazia.
• --resolve-conflict: Instrução se existir um conflito com os dados restaurados. Aceita Substituir ou Ignorar.

O exemplo seguinte utiliza az backup restore-azurefileshare com o modo de restauro como alternativalocation para restaurar a partilha de ficheiros azurefiles na conta de armazenamento afsaccount para a partilha de ficheiros azurefiles1" na conta de armazenamento afaccount1 .

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932883129628959823 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
babeb61c-d73d-4b91-9830-b8bfa83c349a  azurefiles

O atributo Nome na saída corresponde ao nome da tarefa criada pelo serviço de cópia de segurança para a operação de restauro. Para controlar o estado da tarefa, utilize o cmdlet az backup job show .

Recuperação ao nível do item

Pode utilizar esta opção de restauro para restaurar ficheiros ou pastas individuais na localização original ou alternativa.

Defina os seguintes parâmetros para realizar operações de restauro:

• --container-name: o nome da conta de armazenamento que aloja a partilha de ficheiros original de cópia de segurança. Para obter o nome ou o nome amigável do contentor, utilize o comando az backup container list .
• --item-name: o nome da partilha de ficheiros original de cópia de segurança que pretende utilizar para a operação de restauro. Para obter o nome ou o nome amigável do item de cópia de segurança, utilize o comando az backup item list .

Especifique os seguintes parâmetros para os itens que pretende recuperar:

• SourceFilePath: o caminho absoluto do ficheiro, a restaurar na partilha de ficheiros, como uma cadeia. Este caminho é o mesmo caminho utilizado nos comandos az storage file download ou az storage file show CLI.
• SourceFileType: escolha se um diretório ou um ficheiro está selecionado. Aceita Diretório ou Ficheiro.
• ResolveConflict: Instrução se existir um conflito com os dados restaurados. Aceita Substituir ou Ignorar.

Restaurar ficheiros ou pastas individuais para a localização original

Utilize o cmdlet az backup restore-azurefiles com o modo de restauro definido como originallocation para restaurar ficheiros ou pastas específicos para a localização original.

O exemplo seguinte restaura o ficheiro RestoreTest.txt na localização original: a partilha de ficheiros azurefiles .

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore/RestoreTest.txt" --resolve-conflict overwrite  --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

O atributo Nome na saída corresponde ao nome da tarefa criada pelo serviço de cópia de segurança para a operação de restauro. Para controlar o estado da tarefa, utilize o cmdlet az backup job show .

Restaurar ficheiros ou pastas individuais para uma localização alternativa

Para restaurar ficheiros ou pastas específicos para uma localização alternativa, utilize o cmdlet az backup restore-azurefiles com o modo de restauro definido como alternatelocation e especifique os seguintes parâmetros relacionados com o destino:

• --target-storage-account: a conta de armazenamento para a qual o conteúdo da cópia de segurança é restaurado. A conta de armazenamento de destino tem de estar na mesma localização que o cofre.
• --target-file-share: a partilha de ficheiros na conta de armazenamento de destino para a qual o conteúdo da cópia de segurança é restaurado.
• --target-folder: a pasta na partilha de ficheiros para a qual os dados são restaurados. Se o conteúdo da cópia de segurança for restaurado para uma pasta raiz, atribua o valor da pasta de destino como uma cadeia vazia.

O exemplo seguinte restaura o ficheiro RestoreTest.txt originalmente presente na partilha de ficheiros azurefiles para uma localização alternativa: a pasta restoreedata na partilha de ficheiros azurefiles1 alojada na conta de armazenamento afaccount1 .

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --source-file-type file --source-file-path "Restore/RestoreTest.txt" --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

O atributo Nome na saída corresponde ao nome da tarefa criada pelo serviço de cópia de segurança para a operação de restauro. Para controlar o estado da tarefa, utilize o cmdlet az backup job show .

Restaurar vários ficheiros ou pastas para uma localização original ou alternativa

Para efetuar o restauro para múltiplos itens, transmita o valor para o parâmetro source-file-path como caminhos separados por espaço de todos os ficheiros ou pastas que pretende restaurar.

O exemplo seguinte restaura osRestore.txt e os Report.docxficheiros de teste do AFS na respetiva localização original.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932889937058317910 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore Test.txt" "AFS Testing Report.docx" --resolve-conflict overwrite  --out table

O resultado será semelhante ao seguinte:

Name                                          ResourceGroup
------------------------------------          ---------------
649b0c14-4a94-4945-995a-19e2aace0305          azurefiles

O atributo Nome na saída corresponde ao nome da tarefa criada pelo serviço de cópia de segurança para a operação de restauro. Para controlar o estado da tarefa, utilize o cmdlet az backup job show .

Se quiser restaurar vários itens para uma localização alternativa, utilize o comando acima ao especificar parâmetros relacionados com o destino, conforme explicado na secção Restaurar ficheiros ou pastas individuais para uma localização alternativa .

Passos seguintes

Saiba como Gerir cópias de segurança de partilhas de ficheiros do Azure com a CLI do Azure.