Partager via

New-AzResourceGroup

  • Référence
Module:
Az.Resources

Crée un groupe de ressources Azure.

Syntax

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
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
valeur par défaut:False
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Aliases:ResourceGroupName
Position:0
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters: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
Aliases:Tags
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
valeur par défaut:False
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Hashtable

Sorties

PSResourceGroup