Partager via

New-AzResourceGroupDeployment

Module:
Az.Resources Module

Ajoute un déploiement Azure à un groupe de ressources.

Syntaxe

ByTemplateFileWithNoParameters (Par défaut) 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectAndParameterObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateFileAndParameterObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriAndParameterObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceIdAndParamsObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectAndParameterFile 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateFileAndParameterFile 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriAndParameterFile 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceIdAndParams 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByParameterFileWithNoTemplate 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectAndParameterUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateFileAndParameterUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriAndParameterUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceIdAndParamsUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectWithNoParameters 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriWithNoParameters 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceId 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande New-AzResourceGroupDeployment 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 de 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-AzResource. 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. 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

New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -Tag @{"key1"="value1"; "key2"="value2";}

Cette commande crée un déploiement à l’aide d’un modèle personnalisé et d’un fichier de modèle sur le disque, avec un paramètre de balises défini. La commande utilise le paramètre TemplateFile pour spécifier le modèle et le paramètre TemplateParameterFile pour spécifier un fichier qui contient des paramètres et des valeurs de paramètre.

Exemple 2 : Utiliser un objet de modèle personnalisé et un fichier de paramètres pour créer un déploiement

$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\EngineeringSite.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"

Cette commande crée un déploiement à l’aide d’un fichier personnalisé et de modèle sur le disque qui a été converti en table de hachage en mémoire. Les deux premières commandes lisent le texte du fichier de modèle sur le disque et le convertissent en table de hachage en mémoire. La dernière commande utilise le paramètre TemplateObject pour spécifier la table de hachage et le paramètre TemplateParameterFile pour spécifier un fichier qui contient des paramètres et des valeurs de paramètre.

Exemple 3

Ajoute un déploiement Azure à un groupe de ressources. (autogenerated)

New-AzResourceGroupDeployment -DeploymentDebugLogLevel RequestContent -Name mynewstorageaccount -ResourceGroupName 'ContosoEngineering' -TemplateFile 'D:\Azure\Templates\EngineeringSite.json' -TemplateParameterObject <Hashtable>

Exemple 4 : Déployer un modèle stocké dans un compte de stockage non public à l’aide d’un URI et d’un jeton SAP

New-AzResourceGroupDeployment -ResourceGroupName "RGName" -TemplateUri "https://example.com/example.json" -QueryString "foo"

Cette commande crée un déploiement à l’aide du modèle dans TemplateUri, qui n’est pas public et nécessite un paramètre de jeton pour accéder à ce qui serait fourni à l’aide du paramètre QueryString. L’exécution de cette commande accède efficacement au modèle à l’aide de l’URL https://example.com/example.json?foo. Cela peut être utilisé si vous souhaitez utiliser un modèle dans un compte de stockage en fournissant le jeton SAP en tant que QueryString

Exemple 5 : Utiliser un fichier .bicepparam pour créer un déploiement

New-AzResourceGroupDeployment -ResourceGroupName "RGName"  -TemplateParameterFile "./parameters.bicepparam"

Cette commande crée un déploiement au niveau de l’étendue du groupe de ressources à l’aide d’un fichier .bicepparam sur le disque. La commande utilise le paramètre TemplateParameterFile pour spécifier un fichier .bicepparam.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AuxTenant

ID de locataire aux pour les déploiements entre locataires

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeploymentDebugLogLevel

Spécifie un niveau de journal de débogage. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • RequestContent
  • ResponseContent
  • Tous
  • Aucun

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:RequestContent, ResponseContent, All, None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Mode

Spécifie le mode de déploiement. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Terminé : 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.
  • Incrémentiel : en mode incrémentiel, Resource Manager laisse les ressources inchangées qui existent dans le groupe de ressources, mais qui ne sont pas spécifiées dans le modèle.

Propriétés du paramètre

Type:DeploymentMode
Valeur par défaut:Incremental
Valeurs acceptées:Incremental, Complete
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

Nom du déploiement qu’il va créer. S’il n’est pas spécifié, la valeur par défaut est le nom du fichier de modèle lorsqu’un fichier de modèle est fourni ; correspond par défaut à l’heure actuelle où un objet de modèle est fourni, par exemple « 20131223140835 ».

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Nom de déploiement

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProceedIfNoChange

Ne demandez pas de confirmation s’il n’y a aucune modification dans le résultat What-If. Applicable lorsque le commutateur -Confirm est défini.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-QueryString

Chaîne de requête (par exemple, un jeton SAP) à utiliser avec le paramètre TemplateUri. Serait utilisé dans le cas de modèles liés

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Spécifie le nom du groupe de ressources à déployer.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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é.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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é.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SkipTemplateParameterPrompt

Ignore le traitement des paramètres dynamiques PowerShell qui vérifie si le paramètre de modèle fourni contient tous les paramètres nécessaires utilisés par le modèle. Cette vérification invite l’utilisateur à fournir une valeur pour les paramètres manquants, mais la -SkipTemplateParameterPrompt ignore cette invite et l’erreur s’affiche immédiatement si un paramètre n’a pas été lié dans le modèle. Pour les scripts non interactifs, -SkipTemplateParameterPrompt peut être fourni pour fournir un meilleur message d’erreur dans le cas où tous les paramètres requis ne sont pas satisfaits.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

Balises à mettre sur le déploiement.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TemplateFile

Spécifie le chemin d’accès complet d’un fichier de modèle personnalisé. Type de fichier de modèle pris en charge : json et bicep.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByTemplateFileWithNoParameters
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateFileAndParameterObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateFileAndParameterFile
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateFileAndParameterUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-TemplateObject

Table de hachage qui représente le modèle.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByTemplateObjectAndParameterObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateObjectAndParameterFile
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateObjectAndParameterUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateObjectWithNoParameters
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByTemplateObjectAndParameterFile
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateFileAndParameterFile
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateUriAndParameterFile
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateSpecResourceIdAndParams
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByParameterFileWithNoTemplate
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByTemplateObjectAndParameterObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateFileAndParameterObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateUriAndParameterObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateSpecResourceIdAndParamsObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-TemplateParameterUri

Spécifie l’URI d’un fichier de paramètres de modèle. Lorsque vous utilisez TemplateParameterUri, tous les paramètres dynamiques que vous utilisez sont ignorés. Pour utiliser des paramètres dynamiques, vous devez utiliser plutôt le paramètre TemplateParameterFile

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByTemplateObjectAndParameterUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateFileAndParameterUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateUriAndParameterUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateSpecResourceIdAndParamsUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-TemplateSpecId

ID de ressource du templateSpec à déployer.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByTemplateSpecResourceIdAndParamsObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateSpecResourceIdAndParams
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateSpecResourceIdAndParamsUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateSpecResourceId
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-TemplateUri

Spécifie l’URI d’un fichier de modèle personnalisé.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByTemplateUriAndParameterObject
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateUriAndParameterFile
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateUriAndParameterUri
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ByTemplateUriWithNoParameters
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ValidationLevel

Définit le niveau de validation pour valider/what-if. ValidationLevel peut être Template(Skips provider validation), Provider(Performs full validation) ou ProviderNoRbac(Effectue une validation complète à l’aide de vérifications de lecture RBAC au lieu de vérifications d’écriture RBAC pour la validation du fournisseur).

Propriétés du paramètre

Type:String
Valeur par défaut:None(Provider)
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIfExcludeChangeType

Types de modifications de ressources séparés par des virgules à exclure des résultats What-If. Applicable lorsque le commutateur -WhatIf ou -Confirm est défini.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIfResultFormat

Format de résultat What-If.

Propriétés du paramètre

Type:WhatIfResultFormat
Valeur par défaut:None
Valeurs acceptées:ResourceIdOnly, FullResourcePayloads
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Microsoft.Azure.Management.ResourceManager.Models.DeploymentMode

Hashtable

Sorties

PSResourceGroupDeployment