Get-AzTemplateSpec
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 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, opcionalmente, uma versão específica pode 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 *. As 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 *. As versões propriedade 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 retornou ". A propriedade das versões será nulo. 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 ". As versões" do objeto de retorno.
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: a ". A propriedade das 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 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 ". As versões" 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}.
Observação: a ". A propriedade das 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 comunicação com o Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
O nome da especificação de modelo.
Tipo: | String |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ResourceGroupName
O nome do grupo de recursos.
Tipo: | String |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ResourceId
A ID de recurso totalmente qualificada da especificação de modelo. Exemplo: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Tipo: | String |
Aliases: | Id |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Version
A versão da especificação de modelo.
Tipo: | String |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Entradas
Saídas
Azure PowerShell