Get-AzTemplateSpec

Referência

Módulo:: Az.Resources

Obtém ou lista Especificações de 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 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.

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