Get-AzTemplateSpec
Obtém ou lista Especificações de modelo
Sintaxe
ListTemplateSpecsParameterSet (Predefinição)
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 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 -Name ou -ResourceId parâmetros 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, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
| Tipo: | IAzureContextContainer |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
O nome da especificação do modelo.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetTemplateSpecByNameParameterSet
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ResourceGroupName
O nome do grupo de recursos.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ListTemplateSpecsParameterSet
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ResourceId
O ID de recurso totalmente qualificado da especificação do modelo. Exemplo: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft. Resources/templateSpecs/{templateSpecName}
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Id |
Conjuntos de parâmetros
GetTemplateSpecByIdParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Version
A versão da especificação do modelo.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetTemplateSpecByNameParameterSet
| Position: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
GetTemplateSpecByIdParameterSet
| Position: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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.
