Partager via


New-AzResourceGroup

Crée un groupe de ressources Azure.

Syntaxe

New-AzResourceGroup
   [-Name] <String>
   [-Location] <String>
   [-Tag <Hashtable>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzResourceGroup crée un groupe de ressources Azure. Vous pouvez créer un groupe de ressources à l’aide d’un nom et d’un emplacement, puis utiliser l’applet de commande New-AzResource pour créer des ressources à ajouter au groupe de ressources. Pour ajouter un déploiement à un groupe de ressources existant, utilisez l’applet de commande New-AzResourceGroupDeployment. Pour ajouter une ressource à un groupe de ressources existant, utilisez l’applet de commande New-AzResource . Une ressource Azure est une entité Azure gérée par l’utilisateur, telle qu’un serveur de base de données, une base de données ou un site web. Un groupe de ressources Azure est une collection de ressources Azure déployées en tant qu’unité.

Exemples

Exemple 1 : Créer un groupe de ressources vide

New-AzResourceGroup -Name RG01 -Location "South Central US"

Cette commande crée un groupe de ressources qui n’a aucune ressource. Vous pouvez utiliser les applets de commande New-AzResource ou New-AzResourceGroupDeployment pour ajouter des ressources et des déploiements à ce groupe de ressources.

Exemple 2 : Créer un groupe de ressources vide à l’aide de paramètres positionnels

New-AzResourceGroup RG01 "South Central US"

Cette commande crée un groupe de ressources qui n’a aucune ressource.

Exemple 3 : Créer un groupe de ressources avec des balises

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

Cette commande crée un groupe de ressources vide. Cette commande est identique à la commande de l’exemple 1, sauf qu’elle affecte des balises au groupe de ressources. La première balise, nommée Vide, peut être utilisée pour identifier les groupes de ressources qui n’ont aucune ressource. La deuxième balise est nommée Department et a la valeur Marketing. Vous pouvez utiliser une balise telle que celle-ci pour catégoriser les groupes de ressources pour l’administration ou le budget.

Paramètres

-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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

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

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Spécifie l’emplacement du groupe de ressources. Indiquez un emplacement de centre de données Azure, tel que USA Ouest ou Asie Sud-Est. Vous pouvez placer un groupe de ressources à n’importe quel emplacement. Le groupe de ressources n’a pas besoin d’être dans le même emplacement que votre abonnement Azure ou dans le même emplacement que ses ressources. Pour déterminer quel emplacement prend en charge chaque type de ressource, utilisez l’applet de commande Get-AzResourceProvider avec le paramètre ProviderNamespace .

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie un nom pour le groupe de ressources. Le nom de la ressource doit être unique dans l’abonnement. Si un groupe de ressources qui a ce nom existe déjà, la commande vous invite à confirmer avant de remplacer le groupe de ressources existant.

Type:String
Alias:ResourceGroupName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"} Pour ajouter ou modifier une balise, vous devez remplacer la collection d’étiquettes pour le groupe 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 par nom et par valeur. 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 obtenir vos balises prédéfinies, utilisez l’applet de commande Get-AzTag.

Type:Hashtable
Alias:Tags
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Hashtable

Sorties

PSResourceGroup