New-AzureRmResourceGroup
Crée un groupe de ressources Azure.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-AzureRmResourceGroup 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-AzureRmResource 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-AzureRmResourceGroupDeployment. Pour ajouter une ressource à un groupe de ressources existant, utilisez l’applet de commande New-AzureRmResource . 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
PS> New-AzureRmResourceGroup -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-AzureRmResource ou New-AzureRmResourceGroupDeployment 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
PS> New-AzureRmResourceGroup 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
PS> New-AzureRmResourceGroup -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: | 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-AzureRmResourceProvider avec le paramètre ProviderNamespace .
| Type: | String |
| Position: | Named |
| 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: | Named |
| 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-AzureRmResource et Get-AzureRmResourceGroup pour rechercher des ressources et des groupes par nom ou par nom et 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-AzureRMTag.
| 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
None
Sorties
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup