New-AzureRmDeployment

Syntaxe

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzureRmDeployment ajoute un déploiement à l’étendue actuelle de l’abonnement. Cela inclut les ressources dont le déploiement a besoin.

Une ressource Azure est une entité Azure gérée par l’utilisateur. Une ressource peut se trouver dans un groupe de ressources, comme le serveur de base de données, la base de données, le site web, la machine virtuelle ou le compte de stockage. Ou bien, il peut s’agir d’une ressource au niveau de l’abonnement, comme la définition de rôle, la définition de stratégie, etc.

Pour ajouter des ressources à un groupe de ressources, utilisez New-AzureRmDeployment qui crée un déploiement sur un groupe de ressources. L’applet de commande New-AzureRmDeployment crée un déploiement dans l’étendue d’abonnement actuelle, qui déploie les ressources au niveau de l’abonnement.

Pour ajouter un déploiement au niveau de l’abonnement, spécifiez l’emplacement et un modèle. L’emplacement indique à Azure Resource Manager où stocker les données de déploiement. Le modèle est une chaîne JSON qui contient des ressources individuelles à déployer. 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.

Pour utiliser un modèle personnalisé pour le déploiement, 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-AzureRmDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -TemplateVersion "2.1"

Cette commande crée un déploiement au niveau de l’étendue d’abonnement actuelle à 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. Il utilise le paramètre TemplateVersion pour spécifier la version du modèle.

Paramètres

-ApiVersion

-AsJob

-Confirm

-DefaultProfile

-DeploymentDebugLogLevel

-Location

-Name

-Pre

-TemplateFile

-TemplateParameterFile

-TemplateParameterObject

-TemplateParameterUri

-TemplateUri

-WhatIf

Entrées

String

System.Collections.Hashtable

Sorties

PSDeployment