Início rápido: criar e usar um compartilhamento de arquivo SMB do Azure

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada no seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção	Exemplo/Link
Selecione Experimentar no canto superior direito de um bloco de código ou de comando. Selecionar Experimentar não copia automaticamente o código nem o comando para o Cloud Shell.
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador.
Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure.

Para usar o Azure Cloud Shell:

1. Inicie o Cloud Shell.

2. Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou o comando.

3. Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e no Linux, ou selecionando Cmd+Shift+V no macOS.

4. Pressione Enter para executar o código ou comando.

Para instalar e usar o PowerShell localmente, é necessário ter o módulo Az do Azure PowerShell versão 7.0.0 ou mais recente. Recomenda-se instalar a versão mais recente disponível. Para descobrir qual versão do módulo do Azure PowerShell está em execução, execute Get-InstalledModule Az. Se você precisa atualizar, consulte Instalar o módulo do Azure PowerShell. Se você estiver executando o PowerShell localmente, também precisará executar o Login-AzAccount para fazer logon na sua conta do Azure. Para usar a autenticação multifator, você precisará fornecer sua ID de locatário do Azure, como Login-AzAccount -TenantId <TenantId>.

Pré-requisitos

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

• Este artigo exige a versão 2.0.4 ou posterior da CLI do Azure. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.

• Por padrão, os comandos da CLI do Azure retornam JSON (JavaScript Object Notation), que é a maneira padrão de enviar e receber mensagens de APIs REST. Para facilitar o trabalho com as respostas em JSON, alguns dos exemplos neste artigo usam o parâmetro query nos comandos da CLI do Azure. Esse parâmetro utiliza a linguagem de consulta JMESPath para a análise do JSON. Você pode aprender mais sobre como usar os resultados dos comandos da CLI do Azure seguindo a linguagem de consulta JMESPath, consulte o Tutorial de JMESPath.

Uma conta de armazenamento é um pool compartilhado de armazenamento no qual você pode implantar um compartilhamento de arquivos do Azure ou outros recursos de armazenamento como blobs ou filas. Uma conta de armazenamento pode conter uma quantidade ilimitada de compartilhamentos. Um compartilhamento pode conter uma quantidade ilimitada de arquivos, até os limites de capacidade da conta de armazenamento.

Para criar uma conta de armazenamento usando o portal do Azure:

1. Em Serviços do Azure, selecione Contas de armazenamento.

2. Selecione + Criar para criar uma conta de armazenamento.

3. Em Detalhes do projeto, selecione a assinatura do Azure na qual você deseja criar a conta de armazenamento. Se você tiver apenas uma assinatura, ela deverá ser a padrão.

4. Para criar um grupo de recursos, selecione Criar e insira um nome como myexamplegroup.

5. Em Detalhes da instância, forneça um nome para a conta de armazenamento. Pode ser necessário adicionar alguns números aleatórios para torná-lo um nome globalmente exclusivo. Um nome da conta de armazenamento deve estar em minúsculas, só incluir números e ter entre 3 e 24 caracteres. Anote o nome da sua conta de armazenamento. Você o usará mais tarde.

6. Em Região, selecione a região em que você deseja criar a conta de armazenamento.

7. Em Serviço primário, selecione Arquivos do Azure.

8. Em Desempenho, mantenha o valor padrão de Standard.

9. Em Redundância, selecione LRS (armazenamento com redundância local).

   

10. Para revisar as configurações, selecione Revisar + criar. O Azure executará uma validação final.

11. Após a conclusão da validação, escolha Criar. Você deverá ver uma notificação de que a implantação está em andamento.

12. Quando você vir uma notificação de que a implantação está concluída, selecione Ir para o recurso.

PowerShell – Criar um grupo de recursos

Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados. Se você ainda não tem um grupo de recursos do Azure, crie um novo com o cmdlet New-AzResourceGroup. Você precisa de um grupo de recursos para criar uma conta de armazenamento.

O seguinte exemplo cria um grupo de recursos chamado myResourceGroup na região Oeste dos EUA 2:

$resourceGroupName = "myResourceGroup"
$region = "westus2"

New-AzResourceGroup `
    -Name $resourceGroupName `
    -Location $region | Out-Null

PowerShell – Criar uma conta de armazenamento

Uma conta de armazenamento é um pool compartilhado de armazenamento que você pode usar para implantar compartilhamentos de arquivo do Azure.

Este exemplo cria uma conta de armazenamento usando o cmdlet New-AzStorageAccount. A conta de armazenamento é denominada mystorageaccount<número aleatório>, e uma referência a essa conta de armazenamento é armazenada na variável $storageAcct. Os nomes de conta de armazenamento devem ser exclusivo e, portanto, use Get-Random para acrescentar um número aleatório ao nome e torná-lo exclusivo.

$storageAccountName = "mystorageacct$(Get-Random)"

$storageAcct = New-AzStorageAccount `
    -ResourceGroupName $resourceGroupName `
    -Name $storageAccountName `
    -Location $region `
    -Kind StorageV2 `
    -SkuName Standard_LRS `
    -EnableLargeFileShare

CLI – Criar um grupo de recursos

Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados. Se você ainda não tiver um grupo de recursos do Azure, pode usar o comando az group create para criar um. Você precisa de um grupo de recursos para criar uma conta de armazenamento.

O seguinte exemplo cria um grupo de recursos chamado myResourceGroup na localização Oeste dos EUA 2:

export resourceGroupName="myResourceGroup"
region="westus2"

az group create \
    --name $resourceGroupName \
    --location $region \
    --output none

CLI – Criar uma conta de armazenamento

Uma conta de armazenamento é um pool compartilhado de armazenamento em que você pode implantar compartilhamentos de arquivo do Azure.

O exemplo a seguir cria uma conta de armazenamento usando o comando az storage account create. Os nomes de conta de armazenamento devem ser exclusivo e, portanto, use $RANDOM para acrescentar um número aleatório ao nome e torná-lo exclusivo.

export storageAccountName="mystorageacct$RANDOM"

az storage account create \
    --resource-group $resourceGroupName \
    --name $storageAccountName \
    --location $region \
    --kind StorageV2 \
    --sku Standard_LRS \
    --enable-large-file-share \
    --output none

Para criar um compartilhamento de arquivos do Azure:

1. Selecione a conta de armazenamento no seu painel.

2. No menu de serviço, em Armazenamento de dados, selecione Compartilhamentos de arquivos.

   

3. No menu na parte superior da página Compartilhamento de arquivo, selecione + Compartilhamento de arquivo. O menu suspenso da página Novo compartilhamento de arquivos.

4. Em Nome, digite myshare. Os nomes de compartilhamento de arquivos devem ter todos letras minúsculas, números e hifens e devem começar e terminar com uma letra ou número minúsculo. O nome não pode conter dois hífenes consecutivos. Para obter detalhes sobre como nomear arquivos e compartilhamentos de arquivos, confira Nomenclatura e referência de compartilhamentos, diretórios, arquivos e metadados.

5. Deixe a Transação otimizada selecionada para a Camada de acesso.

6. Selecione a guia Backup. Por padrão, o backup é habilitado quando você cria um compartilhamento de arquivo do Azure usando o portal do Azure. Se você quiser desabilitar o backup para o compartilhamento de arquivo, desmarque a caixa de seleção Habilitar backup. Se você quiser habilitar o backup, poderá deixar os padrões ou criar um novo Cofre dos Serviços de Recuperação na mesma região e assinatura da conta de armazenamento. Para criar uma política de backup, selecione Criar uma política.

   

7. Selecione Revisar + criar e, em seguida, Criar para criar o compartilhamento de arquivos do Azure.

Agora que você criou uma conta de armazenamento, crie seu primeiro compartilhamento de arquivo do Azure ao usar o cmdlet New-AzRmStorageShare. Este exemplo cria um compartilhamento chamado myshare com uma cota de 1024 GiB. A cota pode ter no máximo 100 TiB.

$shareName = "myshare"

New-AzRmStorageShare `
    -StorageAccount $storageAcct `
    -Name $shareName `
    -EnabledProtocol SMB `
    -QuotaGiB 1024 | Out-Null

Agora que você criou uma conta de armazenamento, crie seu primeiro compartilhamento de arquivo do Azure ao usar o comando az storage share-rm create. Este exemplo cria um compartilhamento chamado myshare com uma cota de 1024 GiB. A cota pode ter no máximo 100 TiB.

shareName="myshare"

az storage share-rm create \
    --resource-group $resourceGroupName \
    --storage-account $storageAccountName \
    --name $shareName \
    --quota 1024 \
    --enabled-protocols SMB \
    --output none

Para criar um novo diretório chamado myDirectory na raiz do seu compartilhamento de arquivos do Azure:

1. Na página Configurações do compartilhamento de arquivo, selecione o compartilhamento de arquivos myshare. A página do compartilhamento de arquivos é aberta, indicando que nenhum arquivo foi encontrado.
2. No menu na parte superior da página, selecione + Adicionar diretório. Menu suspenso da página Novo diretório.
3. Digite myDirectory e clique em OK.

Para criar um novo diretório chamado myDirectory na raiz do seu compartilhamento de arquivos do Azure, use o cmdlet New-AzStorageDirectory.

New-AzStorageDirectory `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Path "myDirectory"

Para criar um novo diretório chamado myDirectory na raiz do seu compartilhamento de arquivos do Azure, use o comando az storage directory create:

az storage directory create \
   --account-name $storageAccountName \
   --share-name $shareName \
   --name "myDirectory" \
   --output none

Primeiro, é necessário criar ou selecionar um arquivo a ser carregado. Faça isso como preferir. Depois de decidir o arquivo a ser enviad, siga estas etapas:

1. Selecione o diretório myDirectory. O painel myDirectory é aberto.

2. No menu na parte superior, selecione Carregar. O painel Carregar arquivos é aberto.

   

3. Selecione o ícone de pasta para abrir uma janela e procurar seus arquivos locais.

4. Selecione um arquivo e escolha Abrir.

5. Na página Carregar arquivos, verifique o nome do arquivo e clique em Carregar.

6. Quando terminar, o arquivo deverá aparecer na lista da página myDirectory.

Para demonstrar como carregar um arquivo usando o cmdlet Set-AzStorageFileContent, primeiro precisamos criar um arquivo dentro da unidade temporária do Cloud Shell do PowerShell para upload.

Este exemplo coloca a data e a hora atuais em um novo arquivo na unidade temporária e o carrega no compartilhamento de arquivos.

# this expression will put the current date and time into a new file on your scratch drive
cd "~/CloudDrive/"
Get-Date | Out-File -FilePath "SampleUpload.txt" -Force

# this expression will upload that newly created file to your Azure file share
Set-AzStorageFileContent `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Source "SampleUpload.txt" `
   -Path "myDirectory\SampleUpload.txt"

Se você estiver executando o PowerShell localmente, substitua ~/CloudDrive/ por um caminho existente em seu computador.

Depois de carregar o arquivo, use o cmdlet Get-AzStorageFile para verificar se ele foi carregado no compartilhamento de arquivo do Azure.

Get-AzStorageFile `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\" | Get-AzStorageFile

Para demonstrar como carregar um arquivo usando o comando az storage file upload, primeiro crie um arquivo para carregar a unidade temporária do Cloud Shell. No exemplo a seguir, crie e carregue o arquivo:

cd ~/clouddrive/
date > SampleUpload.txt

az storage file upload \
    --account-name $storageAccountName \
    --share-name $shareName \
    --source "SampleUpload.txt" \
    --path "myDirectory/SampleUpload.txt"

Se você estiver executando a CLI do Azure localmente, substitua ~/clouddrive por um caminho existente em seu computador.

Depois de carregar o arquivo, você pode usar o comando az storage file list para verificar se o arquivo foi carregado no compartilhamento de arquivos do Azure:

az storage file list \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory" \
    --output table

Você pode baixar uma cópia do arquivo carregado clicando com o botão direito do mouse no arquivo e selecionando Download. A experiência exata dependerá do sistema operacional e do navegador que você está usando.

Use o cmdlet Get-AzStorageFileContent para baixar uma cópia do arquivo que você carregou na unidade temporária do Cloud Shell.

# Delete an existing file by the same name as SampleDownload.txt, if it exists because you've run this example before.
Remove-Item `
    -Path "SampleDownload.txt" `
    -Force `
    -ErrorAction SilentlyContinue

Get-AzStorageFileContent `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\SampleUpload.txt" `
    -Destination "SampleDownload.txt"

Depois de baixar o arquivo, use o cmdlet Get-ChildItem para ver se ele foi baixado na unidade de rascunho do PowerShell Cloud Shell.

Get-ChildItem | Where-Object { $_.Name -eq "SampleDownload.txt" }

Você pode usar o comando az storage file download para baixar uma cópia do arquivo que você carregou na unidade temporária do Cloud Shell:

# Delete an existing file by the same name as SampleDownload.txt, if it exists, because you've run this example before
rm -f SampleDownload.txt

az storage file download \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory/SampleUpload.txt" \
    --dest "./SampleDownload.txt" \
    --output none

Após a conclusão, exclua o grupo de recursos. A exclusão do grupo de recursos exclui a conta de armazenamento, o compartilhamento de arquivos do Azure e outros recursos implantados dentro do grupo de recursos.

Se houver bloqueios na conta de armazenamento, você precisará removê-los primeiro. Navegue até a conta de armazenamento e selecione Configurações>Bloqueios. Se algum bloqueio estiver listado, exclua-o.

Talvez você também precise excluir o cofre dos Serviços de Recuperação Backup do Azure antes de ter permissão para excluir o grupo de recursos.

1. Selecione Início e Grupos de recursos.
2. Selecione o grupo de recursos que você quer excluir.
3. Selecione Excluir grupo de recursos. Uma janela é aberta e exibe um aviso sobre os recursos que serão excluídos com o grupo de recursos.
4. Insira o nome do grupo de recursos e selecione Excluir.

Ao final, use o cmdlet Remove-AzResourceGroup para excluir o grupo de recursos e todos os recursos contidos nele.

Remove-AzResourceGroup -Name myResourceGroup

Ao final, use o comando az group delete para excluir o grupo de recursos e todos os recursos contidos nele:

az group delete --name $resourceGroupName