Get-AzTemplateSpec

Módulo:

Az.Resources

Obtém ou lista Especificações do modelo

Syntax

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 assinaturas/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 do Modelo em uma assinatura ou grupo de recursos, cada uma retornou Especificações do Modelo ". A propriedade 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: Listar especificações de modelo na assinatura atual

Get-AzTemplateSpec

Lista todas as especificações do 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 do 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 ". 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 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 ". 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 a comunicação com o Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

O nome da especificação do modelo.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

O nome do grupo de recursos.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceId

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

Type:	String
Aliases:	Id
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

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

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

String

Saídas

PSTemplateSpec