Compartilhar via


Get-AzTemplateSpec

Obtém ou lista especificações de modelo

Sintaxe

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

Esse cmdlet pode ser usado para listar especificações de modelo em uma assinatura/grupo de recursos ou obter uma especificação de modelo específica por nome ou id. Ao obter uma especificação de modelo específica por nome/id, opcionalmente, uma versão específica pode ser recuperada especificando um nome de versão por meio do parâmetro -Version. Quando -Version for usado, somente os detalhes específicos da versão estarão presentes em *. As versões no objeto Template Spec retornado. Se nenhuma versão específica for especificada ao recuperar uma Especificação de Modelo por nome/id, todas as versões estarão presentes no *. As versões propriedade do objeto retornado.

Observação: ao listar todas as Especificações de Modelo em uma assinatura ou grupo de recursos, cada especificação de modelo retornou ". A propriedade das versões será nulo. As informações de versão só são incluídas quando -Name ou -ResourceId parâmetros são fornecidos (por exemplo: você está solicitando uma especificação/versão de modelo específica).

Exemplos

Exemplo 1: Listar especificações de modelo na assinatura atual

Get-AzTemplateSpec

Lista todas as Especificações de Modelo na assinatura atual.

Exemplo 2: Listar especificações de modelo em um grupo de recursos

Get-AzTemplateSpec -ResourceGroupName 'myRG'

Lista todas as Especificações de Modelo no grupo de recursos 'myRG' da assinatura atual.

Exemplo 3: Obter especificação de modelo (com todas as versões) pelo nome

Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'

Obtém informações sobre a Especificação de Modelo chamada 'MyTemplateSpec' no grupo de recursos 'myRG'.

Observação: todas as versões da Especificação de Modelo estarão presentes no ". As versões" do objeto de retorno.

Exemplo 4: Obter especificação de modelo (versão específica) pelo nome

Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'

Obtém informações sobre a versão 'v1.0' da Especificação de Modelo chamada 'MyTemplateSpec' dentro do grupo de recursos 'myRG'.

Observação: a ". A propriedade das versões do objeto retornado conterá apenas a versão específica solicitada.

Exemplo 5: Obter especificação de modelo (com todas as versões) por ID do recurso

Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'

Obtém informações sobre a Especificação de Modelo chamada 'MyTemplateSpec' no grupo de recursos 'myRG' da assinatura {subId}.

Observação: todas as versões da Especificação de Modelo estarão presentes no ". As versões" do objeto de retorno.

Exemplo 6: Obter especificação de modelo (versão específica) por id de recurso

Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'

Obtém informações sobre a versão 'v1.0' da Especificação de Modelo chamada 'MyTemplateSpec' dentro do grupo de recursos 'myRG' da assinatura {subId}.

Observação: a ". A propriedade das versões do objeto retornado conterá apenas a versão específica solicitada.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome da especificação de modelo.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceId

A ID de recurso totalmente qualificada da especificação de modelo. Exemplo: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}

Tipo:String
Aliases:Id
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Version

A versão da especificação de modelo.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Saídas

PSTemplateSpec