Tutorial: gerenciar discos com o Azure PowerShell

  • Artigo

Máquinas virtuais (VMs) do Azure usam discos para armazenar o SO (sistema operacional), aplicativos e dados. Ao criar uma VM, é importante escolher um tamanho de disco e a configuração apropriados para a carga de trabalho esperada.

Este tutorial aborda a implantação e o gerenciamento de discos de VM. Neste tutorial, você aprenderá como:

  • Criar, anexar e inicializar um disco de dados
  • Verificar o status de um disco
  • Inicializar um disco
  • Expandir e atualizar um disco
  • Desanexar e excluir um disco

Pré-requisitos

Tenha uma conta do Azure com uma assinatura ativa. 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. Screenshot that shows an example of Try It for Azure Cloud Shell.
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. Button to launch Azure Cloud Shell.
Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure. Screenshot that shows the Cloud Shell button in the Azure portal

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.

Criar uma máquina virtual

Os exercícios neste tutorial exigem uma VM. Siga as etapas nesta seção para criar uma.

Antes de começar, localize a $azRegion variável localizada na primeira linha de código de exemplo e atualize o valor para refletir a região desejada. Por exemplo, para especificar a região EUA Central, use $azRegion = "Central US". Em seguida, use o código para implantar uma VM em um novo grupo de recursos. Os valores de nome de usuário e senha da conta de administrador local da VM serão solicitados.

$azRegion = "[Your Region]"
$azResourceGroup = "myDemoResourceGroup"
$azVMName = "myDemoVM"
$azDataDiskName = "myDemoDataDisk"

New-AzVm `
    -Location $azRegion `
    -ResourceGroupName $azResourceGroup `
    -Name $azVMName `
    -Size "Standard_D2s_v3" `
    -VirtualNetworkName "myDemoVnet" `
    -SubnetName "myDemoSubnet" `
    -SecurityGroupName "myDemoNetworkSecurityGroup" `
    -PublicIpAddressName "myDemoPublicIpAddress"

A saída confirma a criação bem-sucedida da VM.

ResourceGroupName        : myDemoResourceGroup
Id                       : /subscriptions/{GUID}/resourceGroups/myDemoResourceGroup/providers/Microsoft.Compute/virtualMachines/myDemoTestVM
VmId                     : [{GUID}]
Name                     : myDemoVM
Type                     : Microsoft.Compute/virtualMachines
Location                 : centralus
Tags                     : {}
HardwareProfile          : {VmSize}
NetworkProfile           : {NetworkInterfaces}
OSProfile                : {ComputerName, AdminUsername, WindowsConfiguration, AllowExtensionOperations, RequireGuestProvisionSignal}
ProvisioningState        : Succeeded
StorageProfile           : {ImageReference, OsDisk, DataDisks}
FullyQualifiedDomainName : mydemovm-abc123.Central US.cloudapp.azure.com

A VM é provisionada e dois discos são criados e anexados automaticamente.

  • Um disco do sistema operacional, que hospeda o sistema operacional da máquina virtual.
  • Um disco temporário, que é usado principalmente para operações como o processamento de dados temporário.

Adicionar um disco de dados

É recomendável separar dados de aplicativo e de usuário dos dados relacionados ao sistema operacional, quando possível. Se você precisar armazenar dados de usuário ou aplicativo em sua VM, normalmente vai criar e anexar discos de dados adicionais.

Siga as etapas nesta seção para criar, anexar e inicializar um disco de dados na VM.

Crie o disco de dados

Esta seção o orienta pela criação de um disco de dados.

  1. Para um disco de dados ser criado, crie um objeto de disco. O exemplo de código a seguir usa o cmdlet New-AzDiskConfig para configurar um objeto de disco.

    $diskConfig = New-AzDiskConfig `
    -Location $azRegion `
    -CreateOption Empty `
    -DiskSizeGB 128 `
    -SkuName "Standard_LRS"

  2. Depois que o objeto de disco for criado, use o cmdlet New-AzDisk para provisionar um disco de dados.

    $dataDisk = New-AzDisk `
    -ResourceGroupName $azResourceGroup `
    -DiskName $azDataDiskName `
    -Disk $diskConfig

    Você pode usar o cmdlet Get-AzDisk para verificar se o disco foi criado.

    Get-AzDisk `
    -ResourceGroupName $azResourceGroup `
    -DiskName $azDataDiskName

    Neste exemplo, a saída confirma que o disco foi criado. Os valores da propriedade DiskState e ManagedBy confirmam que o disco ainda não está anexado.

    ResourceGroupName            : myDemoResourceGroup
ManagedBy                    :
ManagedByExtended            : {}
OsType                       :
DiskSizeGB                   : 128
DiskSizeBytes                : 137438953472
ProvisioningState            : Succeeded
DiskIOPSReadWrite            : 500
DiskMBpsReadWrite            : 60
DiskState                    : Unattached
Name                         : myDemoDataDisk

Anexar o disco de dados

Um disco de dados deve ser anexado a uma VM para ela acessá-lo. Conclua as etapas nesta seção para criar uma referência para a VM, conectar o disco e atualizar a configuração da VM.

  1. Obtenha a VM à qual você vai anexar o disco de dados. O código de exemplo a seguir usa o cmdlet Get-AzVM para criar uma referência à VM.

    $vm = Get-AzVM `
    -ResourceGroupName $azResourceGroup `
    -Name $azVMName

  2. Anexe o disco de dados à configuração da VM com o cmdlet Add-AzVMDataDisk.

    $vm = Add-AzVMDataDisk `
    -VM $vm `
    -Name $azDataDiskName `
    -CreateOption Attach `
    -ManagedDiskId $dataDisk.Id `
    -Lun 1

  3. Por fim, atualize a configuração da VM com o cmdlet Update-AzVM.

    Update-AzVM `
    -ResourceGroupName $azResourceGroup `
    -VM $vm

    Após uma breve pausa, a saída confirma um anexo bem-sucedido.

    RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
                         True         OK OK

Inicializar o disco de dados

Depois que um disco de dados é anexado à VM, o sistema operacional precisa ser configurado para usar o disco. A seção a seguir apresenta as diretrizes para se conectar à VM remota e configurar o primeiro disco adicionado.

  1. Entre no portal do Azure.

  2. Localize a VM à qual você anexou o disco de dados. Crie uma conexão de protocolo RDP e entre como administrador local.

  3. Depois de estabelecer uma conexão RDP com a VM remota, selecione o menu Iniciar do Windows. Insira o PowerShell na caixa de pesquisa e selecione Windows PowerShell para abrir uma janela do PowerShell.

    Image of a remote desktop connection window.

  4. Na janela Abrir PowerShell, execute o script a seguir.

    Get-Disk | Where PartitionStyle -eq 'raw' |
    Initialize-Disk -PartitionStyle MBR -PassThru |
    New-Partition -AssignDriveLetter -UseMaximumSize |
    Format-Volume -FileSystem NTFS -NewFileSystemLabel "myDemoDataDisk" -Confirm:$false

    A saída confirma uma inicialização bem-sucedida.

    DriveLetter FileSystemLabel FileSystem DriveType HealthStatus OperationalStatus SizeRemaining   Size
----------- --------------- ---------- --------- ------------ ----------------- -------------   ----
F           myDemoDataDisk  NTFS       Fixed     Healthy      OK                    127.89 GB 128 GB

Expandir um disco

Você pode expandir discos do Azure para fornecer capacidade de armazenamento extra quando sua VM estiver com pouco espaço em disco disponível.

Alguns cenários exigem que os dados sejam armazenados no disco do SO. Por exemplo, talvez seja necessário dar suporte a aplicativos herdados que instalam componentes na unidade do SO. Talvez também seja preciso migrar um PC físico local ou VM com uma unidade de SO maior. Nesses casos, pode ser necessário expandir o disco do SO de uma VM.

A redução de um disco existente não tem suporte e pode resultar em perda de dados.

Atualizar o tamanho do disco

Siga as etapas abaixo para redimensionar o disco do SO ou um disco de dados.

  1. Selecione a VM que contém o disco que você redimensionará com o cmdlet Get-AzVM.

     $vm = Get-AzVM `
   -ResourceGroupName $azResourceGroup `
   -Name $azVMName

  2. Para redimensionar o disco de uma VM, interrompa a VM. Use o cmdlet Stop-AzVM para parar a VM. Será solicitada a sua confirmação.

    Importante

    Antes de iniciar um desligamento da VM, sempre confirme se não há recursos ou dados importantes que possam ser perdidos.

    Stop-AzVM `
    -ResourceGroupName $azResourceGroup `
    -Name $azVMName

    Após uma breve pausa, a saída confirma que o computador foi interrompido com êxito.

    OperationId : abcd1234-ab12-cd34-123456abcdef
Status      : Succeeded
StartTime   : 9/13/2021 7:10:23 PM
EndTime     : 9/13/2021 7:11:12 PM
Error       :

  3. Depois que a VM for interrompida, obtenha uma referência para o sistema operacional ou disco de dados anexado à VM com o cmdlet Get-AzDisk.

    O exemplo a seguir seleciona o disco do SO da VM.

    $disk= Get-AzDisk `
    -ResourceGroupName $azResourceGroup `
    -DiskName $vm.StorageProfile.OsDisk.Name

    O exemplo a seguir seleciona o primeiro disco de dados da VM.

        $disk= Get-AzDisk `
        -ResourceGroupName $azResourceGroup `
        -DiskName $vm.StorageProfile.DataDisks[0].Name

  4. Agora que você tem uma referência ao disco, defina o tamanho do disco como 250 GiB.

    Importante

    O novo tamanho deve ser maior que o tamanho do disco existente. O valor máximo permitido é de 4.095 GiB para discos do sistema operacional.

    $disk.DiskSizeGB = 250

  5. A seguir, atualize a imagem do disco com o cmdlet Update-AzDisk.

    Update-AzDisk `
    -ResourceGroupName $azResourceGroup `
    -Disk $disk -DiskName $disk.Name

    A imagem de disco é atualizada e a saída confirma o novo tamanho do disco.

    ResourceGroupName            : myDemoResourceGroup
ManagedBy                    : /subscriptions/{GUID}/resourceGroups/myDemoResourceGroup/providers/Microsoft.Compute/virtualMachines/myDemoVM
Sku                          : Microsoft.Azure.Management.Compute.Models.DiskSku
TimeCreated                  : 9/135/2021 6:41:10 PM
CreationData                 : Microsoft.Azure.Management.Compute.Models.CreationData
DiskSizeGB                   : 250
DiskSizeBytes                : 268435456000
UniqueId                     : {GUID}
ProvisioningState            : Succeeded
DiskIOPSReadWrite            : 500
DiskMBpsReadWrite            : 60
DiskState                    : Reserved
Encryption                   : Microsoft.Azure.Management.Compute.Models.Encryption
Id                           : /subscriptions/{GUID}/resourceGroups/myDemoResourceGroup/providers/Microsoft.Compute/disks/myDemoDataDisk
Name                         : myDemoDataDisk
Type                         : Microsoft.Compute/disks
Location                     : centralus

  6. Por fim, reinicie a VM com o cmdlet Start-AzVM.

    Start-AzVM `
    -ResourceGroupName $azResourceGroup `
    -Name $azVMName

    Após uma breve pausa, a saída confirma que o computador foi iniciado com êxito.

    OperationId : abcd1234-ab12-cd34-123456abcdef
Status      : Succeeded
StartTime   : 9/13/2021 7:44:54 PM
EndTime     : 9/13/2021 7:45:15 PM
Error       :

Expanda o volume do disco no SO

Para aproveitar o novo tamanho do disco, expanda o volume dentro do SO. Siga as etapas abaixo para expandir o volume do disco e aproveitar o novo tamanho do disco.

  1. Entre no portal do Azure.

  2. Localize a VM à qual você anexou o disco de dados. Crie uma conexão de protocolo RDP e entre. Se você não tiver mais acesso a uma conta administrativa, crie um objeto de credencial para um nome de usuário e senha especificados com o cmdlet Get-Credential.

  3. Depois de ter estabelecido uma conexão RDP com a VM remota, selecione o menu Iniciar do Windows. Insira o PowerShell na caixa de pesquisa e selecione Windows PowerShell para abrir uma janela do PowerShell.

    Image of a remote desktop connection window.

  4. Abra o PowerShell e execute o script a seguir. Altere o valor da variável -DriveLetter conforme apropriado. Por exemplo, para redimensionar a partição na unidade F: , use $driveLetter = "F".

    $driveLetter = "[Drive Letter]" 
$size = (Get-PartitionSupportedSize -DriveLetter $driveLetter) 
Resize-Partition `
    -DriveLetter $driveLetter `
    -Size $size.SizeMax

  5. Minimize a janela do RDP e volte para Azure Cloud Shell. Use o cmdlet Get-AzDisk para verificar se o disco foi redimensionado com êxito.

    Get-AzDisk `
    -ResourceGroupName $azResourceGroup | Out-Host -Paging

Atualizar um disco

Há várias maneiras de responder às alterações nas cargas de trabalho da sua organização. Por exemplo, você pode optar por atualizar um HDD Standard para um SSD Premium para lidar com a demanda crescente.

Siga as etapas nesta seção para atualizar um disco gerenciado de Standard para Premium.

  1. Selecione a VM que contém o disco que você vai atualizar com o cmdlet Get-AzVM.

     $vm = Get-AzVM `
   -ResourceGroupName $azResourceGroup `
   -Name $azVMName

  2. Para atualizar o disco de uma VM, interrompa a VM. Use o cmdlet Stop-AzVM para parar a VM. Será solicitada a sua confirmação.

    Importante

    Antes de iniciar um desligamento da VM, sempre confirme se não há recursos ou dados importantes que possam ser perdidos.

    Stop-AzVM `
    -ResourceGroupName $azResourceGroup `
    -Name $azVMName

    Após uma breve pausa, a saída confirma que o computador foi interrompido com êxito.

    OperationId : abcd1234-ab12-cd34-123456abcdef
Status      : Succeeded
StartTime   : 9/13/2021 7:10:23 PM
EndTime     : 9/13/2021 7:11:12 PM
Error       :

  3. Depois que a VM for interrompida, obtenha uma referência para o sistema operacional ou disco de dados anexado à VM com o cmdlet Get-AzDisk.

    O exemplo a seguir seleciona o disco do SO da VM.

    $disk= Get-AzDisk `
    -ResourceGroupName $azResourceGroup `
    -DiskName $vm.StorageProfile.OsDisk.Name

    O exemplo a seguir seleciona o primeiro disco de dados da VM.

        $disk= Get-AzDisk `
        -ResourceGroupName $azResourceGroup `
        -DiskName $vm.StorageProfile.DataDisks[0].Name

  4. Agora que você tem uma referência ao disco, defina a SKU do disco como Premium_LRS.

    $disk.Sku = [Microsoft.Azure.Management.Compute.Models.DiskSku]::new('Premium_LRS')

  5. A seguir, atualize a imagem do disco com o cmdlet Update-AzDisk.

    Update-AzDisk `
    -ResourceGroupName $azResourceGroup `
    -Disk $disk -DiskName $disk.Name

    A imagem do disco está atualizada. Use o código de exemplo a seguir para validar que a SKU do disco foi atualizada.

    $disk.Sku.Name

    A saída confirma a nova SKU do disco.

    Premium_LRS

  6. Por fim, reinicie a VM com o cmdlet Start-AzVM.

    Start-AzVM `
    -ResourceGroupName $azResourceGroup `
    -Name $azVMName

    Após uma breve pausa, a saída confirma que o computador foi iniciado com êxito.

    OperationId : abcd1234-ab12-cd34-123456abcdef
Status      : Succeeded
StartTime   : 9/13/2021 7:44:54 PM
EndTime     : 9/13/2021 7:45:15 PM
Error       :

Desanexar um disco de dados

Você poderá desanexar um disco de dados de uma VM quando quiser anexá-lo a outra VM ou quando ele não for mais necessário. Por padrão, os discos desanexados não são excluídos para evitar a perda de dados não intencional. Um disco desanexado continuará a incorrer em encargos de armazenamento até ser excluído.

  1. Primeiro, selecione a VM à qual o disco está anexado com o cmdlet Get-AzVM.

    $vm = Get-AzVM `
   -ResourceGroupName $azResourceGroup `
   -Name $azVMName

  2. A seguir, desanexe o disco da VM com o cmdlet Remove-AzVMDataDisk.

    Remove-AzVMDataDisk `
    -VM $vm `
    -Name $azDataDiskName

  3. Atualize o estado da VM com o cmdlet Update-AzVM para remover o disco de dados.

    Update-AzVM `
    -ResourceGroupName $azResourceGroup `
    -VM $vm

    Após uma breve pausa, a saída confirma que a VM foi atualizada com êxito.

    RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
                         True         OK OK

Excluir um disco de dados

Quando você exclui uma VM, os discos de dados anexados à VM permanecem provisionados e continuam a incorrer em encargos até serem excluídos. Esse comportamento padrão ajuda a evitar a perda de dados causada por exclusão não intencional.

Você pode usar o exemplo de script do PowerShell a seguir para excluir discos desanexados. A recuperação de discos é limitada ao myDemoResourceGroup porque a opção -ResourceGroupName é usada com o cmdlet Get-AzDisk.

# Get all disks in resource group $azResourceGroup
$allDisks = Get-AzDisk -ResourceGroupName $azResourceGroup

# Determine the number of disks in the collection
if($allDisks.Count -ne 0) {

    Write-Host "Found $($allDisks.Count) disks."

    # Iterate through the collection
    foreach ($disk in $allDisks) {

        # Use the disk's "ManagedBy" property to determine if it is unattached
        if($disk.ManagedBy -eq $null) {

            # Confirm that the disk can be deleted
            Write-Host "Deleting unattached disk $($disk.Name)."
            $confirm = Read-Host "Continue? (Y/N)"
            if ($confirm.ToUpper() -ne 'Y') { break }
            else {

                # Delete the disk
                $disk | Remove-AzDisk -Force 
                Write-Host "Unattached disk $($disk.Name) deleted."
            }
        }
    }
}

O disco de dados desanexado é excluído conforme mostrado pela saída.

Name      : abcd1234-ab12-cd34-ef56-abcdef123456
StartTime : 9/13/2021 10:14:05 AM
EndTime   : 9/13/2021 10:14:35 AM
Status    : Succeeded
Error     :

Limpar os recursos

Quando não forem mais necessários, exclua o grupo de recursos, VM e todos os recursos relacionados. Você pode usar o script do PowerShell de exemplo a seguir para excluir o grupo de recursos criado anteriormente neste tutorial.

Cuidado

Tenha cuidado ao excluir um grupo de recursos. Para evitar a perda de dados importantes, sempre confirme se não há recursos ou dados importantes contidos no grupo de recursos antes de serem excluídos.

    Remove-AzResourceGroup -Name $azResourceGroup

Você é solicitado a confirmar. Após uma breve pausa, a resposta True confirma que o myDemoResourceGroup foi excluído com êxito.

Confirm
Are you sure you want to remove resource group 'myDemoResourceGroup'
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
True

Próximas etapas

Neste tutorial, você aprendeu a:

  • Criar, anexar e inicializar um disco de dados
  • Verificar o status de um disco
  • Inicializar um disco
  • Expandir e atualizar um disco
  • Desanexar e excluir um disco

Vá para o próximo tutorial para saber como automatizar a configuração da VM.

Automatizar a configuração da VM