Set-AzResourceGroup
Modifica un grupo de recursos.
Sintaxis
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
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.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure
Tipo: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Id
Especifica el identificador del grupo de recursos que se va a modificar.
Tipo: | String |
Alias: | ResourceGroupId, ResourceId |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Especifica el nombre del grupo de recursos que se va a modificar.
Tipo: | String |
Alias: | ResourceGroupName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | 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.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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 @{}
.
Tipo: | Hashtable |
Alias: | Tags |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |