Test-AzManagementGroupDeployment
Valide un déploiement dans un groupe d’administration.
Syntax
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Test-AzManagementGroupDeployment
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-QueryString <String>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Test-AzManagementGroupDeployment détermine si un modèle de déploiement et ses valeurs de paramètre sont valides dans un groupe d’administration.
Exemples
Exemple 1 : Tester le déploiement avec un modèle personnalisé et un fichier de paramètres
Test-AzManagementGroupDeployment -ManagementGroupId "myMG" -Location "West US" -TemplateFile "D:\Azure\Templates\OrgSetup.json" -TemplateParameterFile "D:\Azure\Templates\OrgParms.json"
Cette commande teste un déploiement au niveau du groupe d’administration « myMG » à l’aide du fichier de modèle et du fichier de paramètres donnés.
Exemple 2 : Tester le déploiement avec un objet de modèle personnalisé et un fichier de paramètres
$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\OrgSetup.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
Test-AzManagementGroupDeployment -ManagementGroupId "myMG" -Location "West US" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"
Cette commande teste un déploiement au niveau du groupe d’administration « myMG » à l’aide d’une table de hachage en mémoire créée à partir du fichier de modèle donné et d’un fichier de paramètres.
Exemple 3 : Utiliser un fichier .bicepparam pour valider un déploiement
Test-AzManagementGroupDeployment -ManagementGroupId "myManagementGroup" -Location "West US" -TemplateParameterFile "./parameters.bicepparam"
Cette commande valide le déploiement au niveau de l’étendue du groupe d’administration à l’aide d’un fichier .bicepparam sur le disque. La commande utilise le paramètre TemplateParameterFile pour spécifier un fichier .bicepparam.
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Emplacement pour stocker les données de déploiement.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagementGroupId
ID du groupe d’administration.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Nom du déploiement qu’il va tester. 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
Type: | String |
Aliases: | DeploymentName |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Quand elle est définie, indique que l’applet de commande doit utiliser des versions d’API en préversion lors de la détermination automatique de la version à utiliser.
Type: | SwitchParameter |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipTemplateParameterPrompt
Ignore le traitement des paramètres dynamiques PowerShell qui case activée si le paramètre de modèle fourni contient tous les paramètres nécessaires utilisés par le modèle. Cette case activée invite l’utilisateur à fournir une valeur pour les paramètres manquants, mais en fournissant -SkipTemplateParameterPrompt, cette invite et une 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.
Type: | SwitchParameter |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateFile
Chemin d’accès local au fichier de modèle. Type de fichier de modèle pris en charge : json et bicep.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateObject
Table de hachage qui représente le modèle.
Type: | Hashtable |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterFile
Fichier de paramètres à utiliser pour le modèle.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterObject
Table de hachage qui représente les paramètres.
Type: | Hashtable |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterUri
Uri du fichier de paramètres du modèle.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateSpecId
ID de ressource du templateSpec à déployer.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateUri
Uri du fichier de modèle.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entrées
Sorties
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