Partager via


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

Entrées

String

Sorties

PSTemplateSpec