Como marcar uma máquina virtual do Windows no AzureHow to tag a Windows virtual machine in Azure

Este artigo descreve as diferentes maneiras de marcar uma máquina virtual do Windows no Azure por meio do modelo de implantação do Resource Manager.This article describes different ways to tag a Windows virtual machine in Azure through the Resource Manager deployment model. As marcas são pares de chave/valor definidos pelo usuário que podem ser colocados diretamente em um recurso ou grupo de recursos.Tags are user-defined key/value pairs which can be placed directly on a resource or a resource group. Atualmente, o Azure oferece suporte a até 15 marcas por recurso e grupo de recursos.Azure currently supports up to 15 tags per resource and resource group. As marcas podem ser colocadas em um recurso no momento da criação ou adicionadas a um recurso existente.Tags may be placed on a resource at the time of creation or added to an existing resource. Observe que as marcas tem suporte apenas para recursos criados por meio do modelo de implantação do Resource Manager.Please note that tags are supported for resources created via the Resource Manager deployment model only. Se quiser marcar uma máquina virtual Linux, consulte Como marcar uma máquina virtual Linux no Azure.If you want to tag a Linux virtual machine, see How to tag a Linux virtual machine in Azure.

Marcando uma máquina virtual por meio de modelosTagging a Virtual Machine through Templates

Primeiramente, vamos observar uma marcação por meio de modelos.First, let’s look at tagging through templates. Este modelo coloca marcas nos seguintes recursos: Computação (Máquina Virtual), armazenamento (conta de armazenamento) e rede (endereço IP público, rede Virtual e adaptador de rede).This template places tags on the following resources: Compute (Virtual Machine), Storage (Storage Account), and Network (Public IP Address, Virtual Network, and Network Interface). Esse modelo destina-se a uma VM do Windows, mas pode ser adaptada para VMs do Linux.This template is for a Windows VM but can be adapted for Linux VMs.

Clique no botão Implantar no Azure no link do modelo.Click the Deploy to Azure button from the template link. Você será direcionado para o Portal do Azure , onde poderá implantar esse modelo.This will navigate to the Azure portal where you can deploy this template.

Implantação simples com marcas

Esse modelo inclui as seguintes marcas: Departamento, aplicativo, e criado pelo.This template includes the following tags: Department, Application, and Created By. Você pode adicionar/editar essas marcas diretamente no modelo se desejar diferentes nomes de marca.You can add/edit these tags directly in the template if you would like different tag names.

Marcas do Azure em um modelo

Como pode ser visto, as marcas são pares de chave/valor definidos, separados por dois-pontos (:).As you can see, the tags are defined as key/value pairs, separated by a colon (:). As marcas devem ser definidas neste formato:The tags must be defined in this format:

    “tags”: {
        “Key1” : ”Value1”,
        “Key2” : “Value2”
    }

Salve o arquivo de modelo quando terminar de editá-lo com as marcas de sua escolha.Save the template file after you finish editing it with the tags of your choice.

Em seguida, na seção Editar Parâmetros , você pode preencher os valores de suas marcas.Next, in the Edit Parameters section, you can fill out the values for your tags.

Editar marcas no Portal do Azure

Clique em Criar para implantar esse modelo com seus valores de marca.Click Create to deploy this template with your tag values.

Marcando por meio do portalTagging through the Portal

Depois de criar seus recursos com marcas, você pode exibir, adicionar e excluir as marcas no portal.After creating your resources with tags, you can view, add, and delete tags in the portal.

Selecione o ícone de marcas para exibir suas marcas:Select the tags icon to view your tags:

Ícone de marcas no Portal do Azure

Adicione uma nova marca por meio do portal definindo seu próprio par de chave/valor e salve-a.Add a new tag through the portal by defining your own Key/Value pair, and save it.

Adicionar nova marca no Portal do Azure

Agora, a nova marca deve aparecer na lista de marcas do seu recurso.Your new tag should now appear in the list of tags for your resource.

Nova marca salva no Portal do Azure

Marcação com o PowerShellTagging with PowerShell

Para criar, adicionar e excluir marcas pelo PowerShell, primeiramente, você precisa configurar o ambiente do PowerShell com o Azure Resource Manager.To create, add, and delete tags through PowerShell, you first need to set up your PowerShell environment with Azure Resource Manager. Depois de concluir a instalação, você pode colocar marcas em recursos de Computação, Rede e Armazenamento na criação ou depois que o recurso for criado via PowerShell.Once you have completed the setup, you can place tags on Compute, Network, and Storage resources at creation or after the resource is created via PowerShell. Este artigo se concentra na exibição/edição de marcas colocadas nas Máquinas Virtuais.This article will concentrate on viewing/editing tags placed on Virtual Machines.

Observação

Este artigo foi atualizado para usar o novo módulo Az do Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Você ainda pode usar o módulo AzureRM, que continuará a receber as correções de bugs até pelo menos dezembro de 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para saber mais sobre o novo módulo Az e a compatibilidade com o AzureRM, confira Apresentação do novo módulo Az do Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obter instruções de instalação do módulo Az, confira Instalar o Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Primeiramente, navegue para uma Máquina Virtual usando o cmdlet Get-AzVM .First, navigate to a Virtual Machine through the Get-AzVM cmdlet.

    PS C:\> Get-AzVM -ResourceGroupName "MyResourceGroup" -Name "MyTestVM"

Se sua Máquina Virtual já contiver marcas, você verá todas elas no seu recurso:If your Virtual Machine already contains tags, you will then see all the tags on your resource:

    Tags : {
            "Application": "MyApp1",
            "Created By": "MyName",
            "Department": "MyDepartment",
            "Environment": "Production"
           }

Se desejar adicionar marcas por meio do PowerShell, você poderá usar o comando Set-AzResource .If you would like to add tags through PowerShell, you can use the Set-AzResource command. Observe que, ao atualizar marcas pelo PowerShell, as marcas são atualizadas como um todo.Note when updating tags through PowerShell, tags are updated as a whole. Desse modo, se estiver adicionando uma marca a um recurso que já tenha marcas, você precisará incluir todas as marcas que deseja que sejam colocadas no recurso.So if you are adding one tag to a resource that already has tags, you will need to include all the tags that you want to be placed on the resource. Veja abaixo um exemplo de como adicionar mais marcas a um recurso usando cmdlets do PowerShell.Below is an example of how to add additional tags to a resource through PowerShell Cmdlets.

Este primeiro cmdlet define todas as marcações colocadas em MyTestVM para a variável $tags usando as propriedades Get-AzResource e Tags.This first cmdlet sets all of the tags placed on MyTestVM to the $tags variable, using the Get-AzResource and Tags property.

    PS C:\> $tags = (Get-AzResource -ResourceGroupName MyResourceGroup -Name MyTestVM).Tags

O segundo comando exibe as marcas para a variável fornecida.The second command displays the tags for the given variable.

    PS C:\> $tags
    
    Key           Value
    ----          -----
    Department    MyDepartment
    Application   MyApp1
    Created By    MyName
    Environment   Production

O terceiro comando adiciona uma marcação extra à variável $tags .The third command adds an additional tag to the $tags variable. Observe o uso de += para acrescentar o novo par de chave/valor à lista $tags .Note the use of the += to append the new key/value pair to the $tags list.

    PS C:\> $tags += @{Location="MyLocation"}

O quarto comando define todas as marcações definidas na variável $tags para o recurso determinado.The fourth command sets all of the tags defined in the $tags variable to the given resource. Nesse caso, é MyTestVM.In this case, it is MyTestVM.

    PS C:\> Set-AzResource -ResourceGroupName MyResourceGroup -Name MyTestVM -ResourceType "Microsoft.Compute/VirtualMachines" -Tag $tags

O quinto comando exibe todas as marcas no recurso.The fifth command displays all of the tags on the resource. Como você pode ver, Location agora está definido como uma marcação com MyLocation como valor.As you can see, Location is now defined as a tag with MyLocation as the value.

    PS C:\> (Get-AzResource -ResourceGroupName MyResourceGroup -Name MyTestVM).Tags

    Key           Value
    ----          -----
    Department    MyDepartment
    Application   MyApp1
    Created By    MyName
    Environment   Production
    Location      MyLocation

Para saber mais sobre marcação usando o PowerShell, confira Cmdlets de recursos do Azure.To learn more about tagging through PowerShell, check out the Azure Resource Cmdlets.

Exibindo suas marcas nos detalhes de usoViewing your tags in the usage details

As marcas colocadas nos recursos de Computação, Rede e Armazenamento por meio do modelo de implantação do Resource Manager serão populadas nos detalhes de uso no portal de cobrança.Tags placed on Compute, Network, and Storage resources in the Resource Manager deployment model will be populated in your usage details in the billing portal.

Clique em Baixar detalhes de uso para exibir os detalhes de uso da assinatura.Click on Download usage details to view the usage details in your subscription.

Detalhes de uso no Portal do Azure

Selecione o demonstrativo e os detalhes de uso da Versão 2 :Select your billing statement and the Version 2 usage details:

Detalhes de uso da versão de visualização 2 no Portal do Azure

Nos detalhes de uso, você pode ver todas as marcas na coluna Marcas :From the usage details, you can see all of the tags in the Tags column:

Coluna Marcas no Portal do Azure

Ao analisar essas marcas juntamente com o uso, as organizações poderão adquirir novas percepções sobre os respectivos dados de consumo.By analyzing these tags along with usage, organizations will be able to gain new insights into their consumption data.

Próximas etapasNext steps