Get-AzTemplateSpec
Obtém ou lista especificações de modelo
Sintaxe
ListTemplateSpecsParameterSet (Default)
Get-AzTemplateSpec
[[-ResourceGroupName] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetTemplateSpecByNameParameterSet
Get-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[[-Version] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetTemplateSpecByIdParameterSet
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, opcionalmente, 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 *. 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.
Observação: ao listar todas as Especificações de Modelo em uma assinatura ou grupo de recursos, cada especificação de modelo retornada ". A propriedade versions" será nula. 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 ". Propriedade Versions" do objeto return.
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: 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 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 ". Propriedade Versions" do objeto return.
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: 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 a comunicação com o Azure.
Propriedades do parâmetro
| Tipo: | IAzureContextContainer |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
O nome da especificação de modelo.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetTemplateSpecByNameParameterSet
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ResourceGroupName
O nome do grupo de recursos.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ListTemplateSpecsParameterSet
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ResourceId
A ID de recurso totalmente qualificada da especificação de modelo. Exemplo: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | ID |
Conjuntos de parâmetros
GetTemplateSpecByIdParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Version
A versão da especificação de modelo.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetTemplateSpecByNameParameterSet
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
GetTemplateSpecByIdParameterSet
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
