Get-AzTemplateSpec

Referência

Módulo:: Az.Resources

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 um grupo de assinatura/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 opcionalmente ser recuperada 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 *. Propriedade Versions do objeto retornado.

Nota: Ao listar todas as Especificações de Modelo dentro de uma assinatura ou grupo de recursos, cada Especificação de Modelo retornou ". Versions" propriedade será null. 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 específica do modelo).

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) por nome

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

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

Nota: Todas as versões do Template Spec estarão presentes no ". 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' dentro do grupo de recursos 'myRG'.

Nota: O ". A propriedade 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 do Template Spec estarão presentes no ". 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 ". A propriedade 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 comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

O nome da especificação do modelo.

Tipo:	String
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ResourceId

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

Tipo:	String
Aliases:	Id
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Version

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

Tipo:	String
Position:	2
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

Entradas

String

Saídas

PSTemplateSpec

Partilhar via