Compartilhar via

Como marcar uma máquina virtual no Azure usando PowerShell

  • Artigo

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

Este artigo descreve como marcar uma VM no Azure usando o PowerShell. As marcas são pares de chave/valor definidos pelo usuário que podem ser colocados diretamente em um recurso ou grupo de recursos. Atualmente, o Azure permite até 50 marcas por recurso e grupo de recursos. As marcas podem ser colocadas em um recurso no momento da criação ou adicionadas a um recurso existente. Se você quiser marcar uma máquina virtual usando a CLI do Azure, confira Como marcar uma máquina virtual no Azure usando a CLI do Azure.

Use o cmdlet Get-AzVM para exibir a lista atual de marcas para sua VM.

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

Se a Máquina Virtual já contiver marcas, você verá todas elas no formato de lista.

Para adicionar marcas, use o comando Set-AzResource. Ao atualizar marcas pelo PowerShell, as marcas serão atualizadas como um todo. 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. Veja abaixo um exemplo de como adicionar mais marcas a um recurso usando cmdlets do PowerShell.

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

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

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

$tags

Veja a seguir a aparência da saída:

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

No exemplo a seguir, adicionamos uma marca chamada Location com o valor myLocation. Use += para acrescentar o novo par de chave/valor à lista $tags.

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

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

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

Use Get-AzResource para exibir todas as marcas no recurso.

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

A saída, que agora inclui a nova marca, deve ser semelhante a:


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

Próximas etapas