Set-AzResourceGroup

Module:
Az.Resources Module

Modifie un groupe de ressources.

Syntaxe

SetByResourceGroupName (Par défaut) 

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

SetByResourceGroupId 

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

Description

L’applet de commande Set-AzResourceGroup modifie les propriétés d’un groupe de ressources. Vous pouvez utiliser cette applet de commande pour ajouter, modifier ou supprimer les balises Azure appliquées à un groupe de ressources. Spécifiez le paramètre Name pour identifier le groupe de ressources et le paramètre Tag pour modifier les balises. Vous ne pouvez pas utiliser cette applet de commande pour modifier le nom d’un groupe de ressources.

Exemples

Exemple 1 : Appliquer une balise à un groupe de ressources

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

Cette commande applique une balise Department avec une valeur informatique à un groupe de ressources qui n’a pas de balises existantes.

Exemple 2 : Ajouter des balises à un groupe de ressources

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

Cet exemple ajoute une balise Status avec une valeur Approuvée et une balise FY2016 à un groupe de ressources qui a des balises existantes. Étant donné que les balises que vous spécifiez remplacent les balises existantes, vous devez inclure les balises existantes dans la nouvelle collection de balises ou vous les perdrez. La première commande obtient le groupe de ressources ContosoRG et utilise la méthode dot pour obtenir la valeur de sa propriété Tags. La commande stocke les balises dans la variable $Tags. La deuxième commande obtient les balises dans la variable $Tags. La troisième commande utilise l’opérateur d’affectation += pour ajouter les balises Status et FY2016 au tableau d’étiquettes dans la variable $Tags. La quatrième commande utilise le paramètre Tag de Set-AzResourceGroup pour appliquer les balises dans la variable $Tags au groupe de ressources ContosoRG. La cinquième commande obtient toutes les balises appliquées au groupe de ressources ContosoRG. La sortie indique que le groupe de ressources a la balise Department et les deux nouvelles balises, Status et FY2015.

Exemple 3 : Supprimer toutes les balises d’un groupe de ressources

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

Cette commande spécifie le paramètre Tag avec une valeur de table de hachage vide pour supprimer toutes les balises du groupe de ressources ContosoRG.

Paramètres

-AcquirePolicyToken

Acquérir automatiquement un jeton Azure Policy pour cette opération de ressource.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ApiVersion

Spécifie la version de l’API prise en charge par le fournisseur de ressources. Vous pouvez spécifier une version différente de la version par défaut.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ChangeReference

ID de ressource de référence de modification pour cette opération de ressource.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Id

Spécifie l’ID du groupe de ressources à modifier.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ID de groupe de ressources, ResourceId

Jeux de paramètres

SetByResourceGroupId
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie le nom du groupe de ressources à modifier.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ResourceGroupName

Jeux de paramètres

SetByResourceGroupName
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Pre

Indique que cette applet de commande prend en compte les versions d’API en préversion lorsqu’elle détermine automatiquement la version à utiliser.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"} Une balise est une paire nom-valeur que vous pouvez créer et appliquer aux ressources et aux groupes de ressources. Après avoir affecté des balises à des ressources et des groupes, vous pouvez utiliser le paramètre Tag de Get-AzResource et Get-AzResourceGroup pour rechercher des ressources et des groupes par nom ou nom et valeur de balise. Vous pouvez utiliser des balises pour catégoriser vos ressources, telles que par service ou centre de coûts, ou pour suivre les notes ou commentaires sur les ressources. Pour ajouter ou modifier une balise, vous devez remplacer la collection d’étiquettes pour le groupe de ressources. Pour supprimer une balise, entrez une table de hachage avec toutes les balises actuellement appliquées au groupe de ressources, à l’exception de la balise que vous souhaitez supprimer. Pour supprimer toutes les balises d’un groupe de ressources, spécifiez une table de hachage vide : @{}.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Étiquettes

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Hashtable

Sorties

PSResourceGroup