Set-AzResourceGroup

Modifica un grupo de recursos.

Syntax

Set-AzResourceGroup
   -Name <String>
   [-Tag] <Hashtable>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzResourceGroup
   [-Tag] <Hashtable>
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Set-AzResourceGroup modifica las propiedades de un grupo de recursos. Puede usar este cmdlet para agregar, cambiar o eliminar las etiquetas de Azure aplicadas a un grupo de recursos. Especifique el parámetro Name para identificar el grupo de recursos y el parámetro Tag para modificar las etiquetas. No puede usar este cmdlet para cambiar el nombre de un grupo de recursos.

Ejemplos

Ejemplo 1: Aplicación de una etiqueta a un grupo de recursos

Set-AzResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Este comando aplica una etiqueta Department con un valor de TI a un grupo de recursos que no tiene etiquetas existentes.

Ejemplo 2: Agregar etiquetas a un grupo de recursos

$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -Name "ContosoRG").Tags

En este ejemplo se agrega una etiqueta Status con un valor de Approved y una etiqueta FY2016 a un grupo de recursos que tiene etiquetas existentes. Dado que las etiquetas especificadas reemplazan las etiquetas existentes, debe incluir las etiquetas existentes en la nueva colección de etiquetas o perderlas. El primer comando obtiene el grupo de recursos ContosoRG y usa el método dot para obtener el valor de su propiedad Tags. El comando almacena las etiquetas en la variable $Tags. El segundo comando obtiene las etiquetas de la variable $Tags. El tercer comando usa el operador de asignación += para agregar las etiquetas Status y FY2016 a la matriz de etiquetas de la variable $Tags. El cuarto comando usa el parámetro Tag de Set-AzResourceGroup para aplicar las etiquetas de la variable $Tags al grupo de recursos ContosoRG. El quinto comando obtiene todas las etiquetas aplicadas al grupo de recursos ContosoRG. La salida muestra que el grupo de recursos tiene la etiqueta Department y las dos nuevas etiquetas, Status y FY2015.

Ejemplo 3: Eliminación de todas las etiquetas de un grupo de recursos

Set-AzResourceGroup -Name "ContosoRG" -Tag @{}

Este comando especifica el parámetro Tag con un valor de tabla hash vacío para eliminar todas las etiquetas del grupo de recursos ContosoRG.

Parámetros

-ApiVersion

Especifica la versión de API compatible con el proveedor de recursos. Puede especificar una versión diferente de la versión predeterminada.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica el identificador del grupo de recursos que se va a modificar.

Type:String
Aliases:ResourceGroupId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre del grupo de recursos que se va a modificar.

Type:String
Aliases:ResourceGroupName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Indica que este cmdlet considera las versiones de API de versión preliminar cuando determina automáticamente qué versión se va a usar.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"} Una etiqueta es un par nombre-valor que puede crear y aplicar a recursos y grupos de recursos. Después de asignar etiquetas a recursos y grupos, puede usar el parámetro Tag de Get-AzResource y Get-AzResourceGroup para buscar recursos y grupos por nombre o nombre y valor de etiqueta. Puede usar etiquetas para clasificar los recursos, como por departamento o centro de costos, o para realizar un seguimiento de notas o comentarios sobre los recursos. Para agregar o cambiar una etiqueta, debe reemplazar la colección de etiquetas para el grupo de recursos. Para eliminar una etiqueta, escriba una tabla hash con todas las etiquetas aplicadas actualmente al grupo de recursos, desde Get-AzResourceGroup, excepto para la etiqueta que desea eliminar. Para eliminar todas las etiquetas de un grupo de recursos, especifique una tabla hash vacía: @{}.

Type:Hashtable
Aliases:Tags
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Hashtable

Salidas

PSResourceGroup