New-AzResourceGroup
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 |
Default value: | None |
Required: | 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 |
Default value: | False |
Required: | 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 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | 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 |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Sorties
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour