Get-AzTemplateSpec
Obtient ou répertorie les spécifications de modèle
Syntaxe
Get-AzTemplateSpec
[[-ResourceGroupName] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[[-Version] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzTemplateSpec
[[-Version] <String>]
[-ResourceId] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Cette applet de commande peut être utilisée pour répertorier les spécifications de modèle dans un abonnement/groupe de ressources ou obtenir une spécification de modèle spécifique par nom ou ID. Lorsque vous obtenez une spécification de modèle spécifique par nom/ID, une version spécifique peut éventuellement être récupérée en spécifiant un nom de version via le paramètre -Version . Lorsque -Version est utilisée, seuls les détails de version spécifiques sont présents dans *. Versions sur l’objet Spec de modèle retourné. Si aucune version spécifique n’est spécifiée lors de la récupération d’une spécification de modèle par nom/ID, toutes les versions sont présentes dans le *. Propriété Versions de l’objet retourné.
Remarque : Lors de la liste de toutes les spécifications de modèle au sein d’un abonnement ou d’un groupe de ressources, chaque spécification de modèle retournée est « ». La propriété Versions est null. Les informations de version sont incluses uniquement lorsque les paramètres -Name ou -ResourceId sont fournis (par exemple, vous demandez une spécification/une version de modèle spécifique).
Exemples
Exemple 1 : Répertorier les spécifications du modèle dans l’abonnement actuel
Get-AzTemplateSpec
Répertorie toutes les spécifications de modèle dans l’abonnement actuel.
Exemple 2 : Répertorier les spécifications de modèle dans un groupe de ressources
Get-AzTemplateSpec -ResourceGroupName 'myRG'
Répertorie toutes les spécifications de modèle dans le groupe de ressources « myRG » de l’abonnement actuel.
Exemple 3 : Obtenir la spécification du modèle (avec toutes les versions) par nom
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'
Obtient des informations sur la spécification de modèle nommée « MyTemplateSpec » dans le groupe de ressources « myRG ».
Remarque : toutes les versions de la spécification de modèle sont présentes dans le « . Propriété Versions » de l’objet de retour.
Exemple 4 : Obtenir la spécification du modèle (version spécifique) par nom
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'
Obtient des informations sur la version « v1.0 » de la spécification de modèle nommée « MyTemplateSpec » dans le groupe de ressources « myRG ».
Remarque : Le « ». La propriété Versions » de l’objet retourné contient uniquement la version spécifique demandée.
Exemple 5 : Obtenir la spécification du modèle (avec toutes les versions) par ID de ressource
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'
Obtient des informations sur la spécification de modèle nommée « MyTemplateSpec » dans le groupe de ressources « myRG » de l’abonnement {subId}.
Remarque : toutes les versions de la spécification de modèle sont présentes dans le « . Propriété Versions » de l’objet de retour.
Exemple 6 : Obtenir une spécification de modèle (version spécifique) par ID de ressource
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'
Obtient des informations sur la version « v1.0 » de la spécification de modèle nommée « MyTemplateSpec » dans le groupe de ressources « myRG » de l’abonnement {subId}.
Remarque : Le « ». La propriété Versions » de l’objet retourné contient uniquement la version spécifique demandée.
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzContext, 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 |
-Name
Nom de la spécification du modèle.
Type: | String |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceGroupName
Nom du groupe de ressources.
Type: | String |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceId
ID de ressource complet de la spécification du modèle. Exemple : /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Type: | String |
Alias: | Id |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Version
Version de la spécification du modèle.
Type: | String |
Position: | 2 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |