Partilhar via


Como etiquetar uma máquina virtual no Azure com o PowerShell

Aplica-se a: ✔️ VMs do Windows VMs ✔️ do Linux Conjuntos ✔️ de dimensionamento ✔️ flexíveis Conjuntos de dimensionamento uniformes

Este artigo descreve como etiquetar uma VM no Azure com o PowerShell. As etiquetas são pares chave/valor definidos pelo utilizador que podem ser colocados diretamente num recurso ou num grupo de recursos. Atualmente, o Azure suporta até 50 etiquetas por recurso e grupo de recursos. As etiquetas podem ser colocadas num recurso no momento da criação ou adicionadas a um recurso existente. Se quiser etiquetar uma máquina virtual com a CLI do Azure, veja Como etiquetar uma máquina virtual no Azure com a CLI do Azure.

Utilize o Get-AzVM cmdlet para ver a lista atual de etiquetas da VM.

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

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

Para adicionar etiquetas, utilize o Set-AzResource comando . Ao atualizar etiquetas através do PowerShell, as etiquetas 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. Segue-se um exemplo de como adicionar etiquetas adicionais a um recurso através de Cmdlets do PowerShell.

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

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

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

$tags

Eis o aspeto da saída:

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

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

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

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

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

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

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

O resultado deve ter um aspeto semelhante ao seguinte, que agora inclui a nova etiqueta:


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

Passos seguintes