Get-AzTemplateSpec

Módulo:

Az.Resources

Obtém ou lista as especificações do 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, uma versão específica pode ser recuperada opcionalmente especificando um nome de versão por meio do parâmetro -Version . Quando -Version é usado, apenas os detalhes específicos da versão estarão presentes em *. 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 *. Versions do objeto retornado.

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

Exemplos

Exemplo 1: Especificações de modelo de lista 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) por nome

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

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

Nota: Todas as versões da especificação do modelo estarão presentes no arquivo ". Versions" do objeto de retorno.

Exemplo 4: Obter especificação de modelo (versão específica) por 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' no grupo de recursos 'myRG'.

Nota: O domínio ". Versions" 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 de 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' dentro do grupo de recursos 'myRG' da assinatura {subId}.

Nota: Todas as versões da especificação do modelo estarão presentes no arquivo ". Versions" 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}.

Nota: O domínio ". Versions" 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 a 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 do 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 do 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