Guia de início rápido: criar e usar um compartilhamento de arquivos do Azure SMB

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

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

Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção	Exemplo/Ligação
Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell.
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser.
Selecione o botão Cloud Shell na barra de menus, na parte direita 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 comando.

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

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

Se quiser instalar e usar o PowerShell localmente, você precisará do módulo Az do Azure PowerShell versão 7.0.0 ou posterior. Recomendamos a instalação da versão mais recente disponível. Para descobrir qual versão do módulo do Azure PowerShell você está executando, execute Get-InstalledModule Az. Se precisar de atualizar, veja Install Azure PowerShell module (Instalar o módulo do Azure PowerShell). Se você estiver executando o PowerShell localmente, também precisará executar para fazer Login-AzAccount logon em 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, consulte Guia de início rápido para 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, consulte Como executar a CLI do Azure em um contêiner 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 entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, 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 artigo requer a versão 2.0.4 ou posterior da CLI do Azure. Se estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.

• Por padrão, os comandos da CLI do Azure retornam JavaScript Object Notation (JSON), que é a maneira padrão de enviar e receber mensagens de APIs REST. Para facilitar a utilização das respostas JSON, alguns dos exemplos neste artigo utilizam o parâmetro query nos comandos da CLI do Azure. Este parâmetro utiliza a linguagem de consulta JMESPath para analisar o JSON. Para saber mais sobre como utilizar os resultados dos comandos da CLI do Azure ao seguir a linguagem de consulta do JMESPath, veja o tutorial JMESPath.

Uma conta de armazenamento é um conjunto partilhado de armazenamento no qual pode implementar uma partilha de ficheiros do Azure ou outros recursos de armazenamento, como blobs ou filas. Uma conta de armazenamento pode conter um número ilimitado de partilhas. Uma partilha pode armazenar um número ilimitado de ficheiros, até aos 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 criar a conta de armazenamento. Se tiver apenas uma subscrição, deve ser a predefinição.

4. Se quiser criar um novo grupo de recursos, selecione Criar novo e insira um nome como myexamplegroup.

5. Em Detalhes da instância, forneça um nome para a conta de armazenamento. Talvez seja necessário adicionar alguns números aleatórios para torná-lo um nome globalmente exclusivo. Um nome de conta de armazenamento deve ser todo minúsculo e números, e deve ter entre 3 e 24 caracteres. Tome nota do nome da conta de armazenamento. Vai utilizá-lo mais tarde.

6. Em Região, selecione a região na qual você deseja criar sua conta de armazenamento.

7. Em Serviço principal, selecione Arquivos do Azure.

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

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

   

10. Selecione Rever + criar para rever as suas definições. O Azure executará uma validação final.

11. Quando a validação estiver concluída, selecione Criar. Você verá uma notificação de que a implantação está em andamento.

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

PowerShell - Criar um grupo de recursos

Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos. Se você ainda não tiver 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 exemplo a seguir 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 arquivos do Azure.

Este exemplo cria uma conta de armazenamento usando o cmdlet New-AzStorageAccount . A conta de armazenamento é denominada mystorageaccount<random number> e uma referência a essa conta de armazenamento é armazenada na variável $storageAcct. Os nomes das contas de armazenamento devem ser exclusivos, portanto, use Get-Random para acrescentar um número aleatório ao nome para 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 contentor lógico no qual os recursos do Azure são implementados e geridos. Se ainda não tiver um grupo de recursos do Azure, pode utilizar o comando az group create para criar um. Você precisa de um grupo de recursos para criar uma conta de armazenamento.

O exemplo a seguir cria um grupo de recursos chamado myResourceGroup no local West US 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 no qual você pode implantar compartilhamentos de arquivos do Azure.

O exemplo a seguir cria uma conta de armazenamento usando o comando az storage account create . Os nomes das contas de armazenamento devem ser exclusivos, portanto, use $RANDOM para acrescentar um número aleatório ao nome para 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 uma partilha de ficheiros do Azure:

1. Selecione a conta de armazenamento a partir do dashboard.

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

   

3. No menu na parte superior da página Compartilhamentos de arquivos, selecione + Compartilhamento de arquivos. É apresentada a página Nova partilha de ficheiros.

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

5. Deixe 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 arquivos do Azure usando o portal do Azure. Se quiser desativar o backup para o compartilhamento de arquivos, desmarque a caixa de seleção Habilitar backup . Se quiser habilitar o backup, você pode 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 nova política de backup, selecione Criar uma nova política.

   

7. Selecione Rever + criar e, em seguida, Criar para criar a partilha de ficheiros do Azure.

Agora que você criou uma conta de armazenamento, pode criar seu primeiro compartilhamento de arquivos do Azure usando o cmdlet New-AzRmStorageShare . Este exemplo cria um compartilhamento chamado myshare com uma cota de 1024 GiB. A quota pode ser de, 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, pode criar seu primeiro compartilhamento de arquivos do Azure usando o comando az storage share-rm create . Este exemplo cria um compartilhamento chamado myshare com uma cota de 1024 GiB. A quota pode ser de, 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 com o nome myDirectory na raiz da partilha de ficheiros do Azure:

1. Na página Configurações de compartilhamento de arquivos, 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. É apresentada a página Novo diretório.
3. Digite myDirectory e selecione OK.

Para criar um novo diretório chamado myDirectory na raiz do 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 com o nome myDirectory na raiz da partilha de ficheiros do Azure, utilize o comando az storage directory create:

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

Primeiro, você precisa criar ou selecionar um arquivo para carregar. Faça isso por qualquer meio que achar melhor. Quando tiver decidido o ficheiro que pretende carregar, siga estes passos:

1. Selecione o diretório myDirectory . É aberto o painel myDirectory.

2. No menu na parte superior, selecione Carregar. É aberto o painel Carregar ficheiros.

   

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

4. Selecione um arquivo e, em seguida, selecione Abrir.

5. Na página Carregar ficheiros, verifique o nome do ficheiro e, em seguida, selecione Carregar.

6. Quando terminar, o ficheiro deve aparecer na lista na página myDirectory.

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

Este exemplo coloca a data e hora atuais num novo ficheiro no disco e, em seguida, carrega o ficheiro para a partilha de ficheiros.

# 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 que existe em sua máquina.

Depois de carregar o arquivo, você pode usar o cmdlet Get-AzStorageFile para verificar se o arquivo foi carregado em seu compartilhamento de arquivos do Azure.

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

Para demonstrar como carregar um ficheiro com o comando az storage file upload, primeiro crie um ficheiro para carregar na unidade temporária do Cloud Shell. No exemplo seguinte, irá criar e carregar o ficheiro:

cd ~/clouddrive/
date > SampleUpload.txt

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

Se estiver a executar a CLI do Azure localmente, substitua ~/clouddrive por um caminho existente no seu computador.

Depois de carregar o ficheiro, pode utilizar o comando az storage file list para assegurar que o ficheiro foi carregado para a partilha de ficheiros do Azure:

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

Pode transferir uma cópia do ficheiro que carregou clicando com o botão direito do rato no ficheiro e selecionando Transferir. A experiência exata dependerá do sistema operacional e do navegador que você está usando.

Você pode usar o cmdlet Get-AzStorageFileContent para baixar uma cópia do arquivo carregado na unidade de trabalho 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, você pode usar o Get-ChildItem cmdlet para ver se o arquivo foi baixado para a unidade de trabalho do PowerShell Cloud Shell.

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

Pode utilizar o comando az storage file download para transferir uma cópia do ficheiro que carregou para a 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

Quando terminar, exclua o grupo de recursos. A exclusão do grupo de recursos exclui a conta de armazenamento, o compartilhamento de arquivos do Azure e quaisquer 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 Bloqueios de configurações>. Se algum bloqueio estiver listado, exclua-o.

Também pode ser necessário excluir o cofre dos Serviços de Recuperação de Backup do Azure antes de ter permissão para excluir o grupo de recursos.

1. Selecione Página Inicial e, em seguida, Grupos de recursos.
2. Selecione o grupo de recursos que pretende eliminar.
3. Selecione Eliminar grupo de recursos. É aberta uma janela com um aviso sobre os recursos que serão eliminados com o grupo de recursos.
4. Introduza o nome do grupo de recursos e, em seguida, selecione Eliminar.

Quando terminar, você poderá usar o cmdlet Remove-AzResourceGroup para excluir o grupo de recursos e todos os recursos contidos no grupo de recursos.

Remove-AzResourceGroup -Name myResourceGroup

Quando terminar, você poderá usar o az group delete comando para excluir o grupo de recursos e todos os recursos contidos no grupo de recursos:

az group delete --name $resourceGroupName