New-AzureRmResourceGroupDeployment
Ajoute un déploiement Azure à un groupe de ressources.
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-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-AzureRmResourceGroupDeployment ajoute un déploiement à un groupe de ressources existant. Cela inclut les ressources dont le déploiement a besoin. 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, un site web, une machine virtuelle ou un compte Stockage. Un groupe de ressources Azure est une collection de ressources Azure déployées en tant qu’unité, telles que le site web, le serveur de base de données et les bases de données nécessaires pour un site web financier. Un déploiement de groupe de ressources utilise un modèle pour ajouter des ressources à un groupe de ressources et les publier afin qu’elles soient disponibles dans Azure. Pour ajouter des ressources à un groupe de ressources sans utiliser de modèle, utilisez l’applet de commande New-AzureRmResource. Pour ajouter un déploiement de groupe de ressources, spécifiez le nom d’un groupe de ressources existant et d’un modèle de groupe de ressources. Un modèle de groupe de ressources est une chaîne JSON qui représente un groupe de ressources pour un service cloud complexe, tel qu’un portail web. Le modèle inclut des espaces réservés de paramètres pour les ressources requises et des valeurs de propriété configurables, telles que les noms et les tailles. Vous trouverez de nombreux modèles dans la galerie de modèles Azure ou vous pouvez créer vos propres modèles. Vous pouvez utiliser l’applet de commande Get-AzureRmResourceGroupGalleryTemplate pour rechercher un modèle dans la galerie. Pour utiliser un modèle personnalisé pour créer un groupe de ressources, spécifiez le paramètre TemplateFile ou le paramètre TemplateUri. Chaque modèle a des paramètres pour les propriétés configurables. Pour spécifier des valeurs pour les paramètres de modèle, spécifiez le paramètre TemplateParameterFile ou le paramètre TemplateParameterObject . Vous pouvez également utiliser les paramètres de modèle qui sont ajoutés dynamiquement à la commande lorsque vous spécifiez un modèle. Pour utiliser des paramètres dynamiques, tapez-les à l’invite de commandes ou tapez un signe moins (-) pour indiquer un paramètre et utilisez la touche Tab pour parcourir les paramètres disponibles. Les valeurs des paramètres de modèle que vous entrez à l’invite de commandes sont prioritaires sur les valeurs d’un objet ou d’un fichier de paramètre de modèle.
Exemples
Exemple 1 : Utiliser un modèle personnalisé et un fichier de paramètres pour créer un déploiement
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"Cette commande crée un déploiement à l’aide d’un modèle personnalisé et d’un fichier de modèle sur le disque. La commande utilise le paramètre TemplateFile pour spécifier le modèle et le paramètre TemplateParameterFile pour spécifier le fichier qui contient les paramètres et leurs valeurs.
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 |
-AsJob
Exécuter l’applet de commande en arrière-plan
| 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 |
-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 |
-DeploymentDebugLogLevel
Spécifie un niveau de journal de débogage. Les valeurs valides pour ce paramètre sont :
- RequestContent
- ResponseContent
- Tous
- Aucun
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| 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 |
-Mode
Spécifie le mode de déploiement. Les valeurs valides pour ce paramètre sont :
- Terminé
- Incrémentiel en mode complet, Resource Manager supprime les ressources qui existent dans le groupe de ressources, mais qui ne sont pas spécifiées dans le modèle. En mode incrémentiel, Resource Manager conserve telles quelles les ressources qui existent dans le groupe de ressources, mais qui ne sont pas spécifiées dans le modèle.
| Type: | DeploymentMode |
| Position: | Named |
| Valeur par défaut: | Incremental |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom du déploiement du groupe de ressources à créer.
| Type: | String |
| Alias: | DeploymentName |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| 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 |
-ResourceGroupName
Spécifie le nom du groupe de ressources à déployer.
| 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 |
-RollBackDeploymentName
La restauration vers le déploiement réussi avec le nom donné dans le groupe de ressources ne doit pas être utilisée si -RollbackToLastDeployment est utilisé.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-RollbackToLastDeployment
La restauration vers le dernier déploiement réussi dans le groupe de ressources ne doit pas être présente si -RollBackDeploymentName est utilisé.
| 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 |
-TemplateFile
Spécifie le chemin complet d’un fichier de modèle JSON. Il peut s’agir d’un modèle personnalisé ou d’un modèle de galerie enregistré en tant que fichier JSON, tel qu’un modèle créé à l’aide de l’applet de commande Save-AzureRmResourceGroupGalleryTemplate .
| 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 |
-TemplateParameterFile
Spécifie le chemin d’accès complet d’un fichier JSON qui contient les noms et les valeurs des paramètres du modèle. Si un modèle a des paramètres, vous devez spécifier les valeurs de paramètre avec le paramètre TemplateParameterFile ou le paramètre TemplateParameterObject . Les paramètres de modèle sont ajoutés dynamiquement à la commande lorsque vous spécifiez un modèle. Pour utiliser les paramètres dynamiques, tapez un signe moins (-) pour indiquer un nom de paramètre, puis utilisez la touche Tab pour parcourir les paramètres disponibles.
| 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 |
-TemplateParameterObject
Spécifie une table de hachage des noms et des valeurs des paramètres de modèle.
Pour obtenir de l’aide sur les tables de hachage dans Windows PowerShell, tapez Get-Help about_Hash_Tables.
Si un modèle a des paramètres, vous devez spécifier des valeurs de paramètre.
Les paramètres de modèle sont ajoutés dynamiquement à la commande lorsque vous spécifiez un modèle.
| Type: | Hashtable |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-TemplateParameterUri
Spécifie l’URI d’un fichier de paramètres de modèle.
| 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 |
-TemplateUri
Spécifie l’URI d’un fichier de modèle JSON. Ce fichier peut être un modèle personnalisé ou un modèle de galerie enregistré en tant que fichier JSON, par exemple à l’aide de Save-AzureRmResourceGroupGalleryTemplate.
| 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 |
-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.ResourceManager.Models.PSResourceGroupDeployment