Como marcar uma máquina virtual em Azure usando o PowerShell

Este artigo descreve como marcar um VM em Azure usando PowerShell. As etiquetas são pares chave/valor definidos pelo utilizador que podem ser colocados diretamente num recurso ou num grupo de recursos. A Azure suporta atualmente até 50 tags por grupo de recursos e recursos. As etiquetas podem ser colocadas num recurso no momento da criação ou adicionadas a um recurso existente. Se pretender marcar uma máquina virtual utilizando o Azure CLI, consulte Como marcar uma máquina virtual em Azure utilizando o Azure CLI.

Utilize o Get-AzVM cmdlet para visualizar a lista atual de etiquetas para o seu VM.

Get-AzVM -ResourceGroupName "myResourceGroup" -Name "myVM" | Format-List -Property Tags

Se a sua Máquina Virtual já tiver etiquetas, verá todas as tags no formato da lista.

Para adicionar tags, use o Set-AzResource comando. Ao atualizar as tags através do PowerShell, as tags são atualizadas como um todo. Se estiver a adicionar uma etiqueta a um recurso que já tenha etiquetas, terá de incluir todas as etiquetas que pretende colocar no recurso. Abaixo está um exemplo de como adicionar tags adicionais a um recurso através de PowerShell Cmdlets.

Atribua todas as etiquetas atuais para o VM à $tags variável, utilizando a Get-AzResource propriedade e a Tags propriedade.

$tags = (Get-AzResource -ResourceGroupName myResourceGroup -Name myVM).Tags

Para ver as etiquetas atuais, digite a variável.

$tags

Aqui está o que a saída pode parecer:

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

No exemplo seguinte, adicionamos uma etiqueta chamada Location com o myLocation valor. Utilize += para anexar o novo par de chave/valor à $tags lista.

$tags += @{Location="myLocation"}

Utilize Set-AzResource para definir todas as etiquetas definidas na variável $tags no VM.

Set-AzResource -ResourceGroupName myResourceGroup -Name myVM -ResourceType "Microsoft.Compute/VirtualMachines" -Tag $tags

Utilize Get-AzResource para exibir todas as etiquetas no recurso.

(Get-AzResource -ResourceGroupName myResourceGroup -Name myVM).Tags

A saída deve parecer-se com o seguinte, que agora inclui a nova etiqueta:


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

Passos seguintes