Compartir a través de

Etiquetado de una máquina virtual en Azure con PowerShell

  • Artículo

Se aplica a: ✔️ Máquinas virtuales Linux ✔️ Máquinas virtuales Windows ✔️ Conjuntos de escalado flexibles ✔️ Conjuntos de escalado uniformes

En este artículo se describe cómo etiquetar una máquina virtual en Azure mediante PowerShell. Las etiquetas son pares clave-valor definidos por el usuario que se pueden colocar directamente en un recurso o un grupo de recursos. Actualmente, Azure admite un máximo de 50 etiquetas por recurso y grupo de recursos. Las etiquetas se pueden colocar en un recurso en el momento de su creación, o bien se pueden agregar a un recurso existente. Si quiere etiquetar una máquina virtual con la CLI de Azure, consulte Etiquetado de una máquina virtual Linux en Azure.

Use el cmdlet Get-AzVM para ver la lista actual de etiquetas para su máquina virtual.

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

Si la máquina virtual ya contiene etiquetas, las verá todas en formato de lista.

Para agregar etiquetas, use el comando Set-AzResource. Si actualiza las etiquetas mediante PowerShell, se actualizan todas ellas en conjunto. Si va a agregar una etiqueta a un recurso que ya tiene etiquetas, tendrá que incluir todas las etiquetas que desea colocar en el recurso. A continuación se muestra un ejemplo de cómo agregar etiquetas adicionales a un recurso mediante los cmdlets de PowerShell.

Asigne todas las etiquetas actuales de la máquina virtual a la variable $tags, mediante las propiedades Get-AzResource y Tags.

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

Para ver las etiquetas actuales, escriba la variable.

$tags

Este es el aspecto que podría tener el resultado:

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

En el ejemplo siguiente, se agrega una etiqueta llamada Location con el valor myLocation. Use += para anexar el nuevo par de clave-valor a la lista $tags.

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

Use Set-AzResource para establecer todas las etiquetas definidas en la variable $tags en la máquina virtual.

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

Use Get-AzResource para mostrar todas las etiquetas del recurso.

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

La salida debe tener un aspecto similar al siguiente, que ahora incluye la nueva etiqueta:


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

Pasos siguientes