Compartir a través de


Get-AzTemplateSpec

Obtiene o enumera las especificaciones de plantilla

Sintaxis

ListTemplateSpecsParameterSet (valor predeterminado)

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

Este cmdlet se puede usar para enumerar las especificaciones de plantilla en un grupo de recursos o suscripción o obtener una especificación de plantilla específica por nombre o identificador. Al obtener una especificación de plantilla específica por nombre o identificador, se puede recuperar opcionalmente una versión específica especificando un nombre de versión mediante el parámetro -Version . Cuando se usa -Version , solo los detalles de la versión específicos estarán presentes en *. Versiones en el objeto De especificación de plantilla devuelto. Si no se especifica ninguna versión específica al recuperar una especificación de plantilla por nombre o identificador, todas las versiones estarán presentes en *. Propiedad Versions del objeto devuelto.

Nota: Al enumerar todas las especificaciones de plantilla dentro de una suscripción o un grupo de recursos, cada especificación de plantilla devuelta ". La propiedad Versions" será null. La información de versión solo se incluye cuando se proporcionan -Name o parámetros de -ResourceId (por ejemplo, se solicita una especificación o versión de plantilla específica).

Ejemplos

Ejemplo 1: Enumerar Especificaciones de plantilla en la suscripción actual

Get-AzTemplateSpec

Enumera todas las especificaciones de plantilla de la suscripción actual.

Ejemplo 2: Enumerar especificaciones de plantilla en un grupo de recursos

Get-AzTemplateSpec -ResourceGroupName 'myRG'

Enumera todas las especificaciones de plantilla del grupo de recursos "myRG" de la suscripción actual.

Ejemplo 3: Obtener especificación de plantilla (con todas las versiones) por nombre

Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'

Obtiene información sobre la especificación de plantilla denominada "MyTemplateSpec" dentro del grupo de recursos "myRG".

Nota: Todas las versiones de la especificación de plantilla estarán presentes en ". Propiedad Versions" del objeto devuelto.

Ejemplo 4: Obtener especificación de plantilla (versión específica) por nombre

Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'

Obtiene información sobre la versión "v1.0" de la especificación de plantilla denominada "MyTemplateSpec" dentro del grupo de recursos "myRG".

Nota: El ". La propiedad Versions" del objeto devuelto contendrá solo la versión específica solicitada.

Ejemplo 5: Obtener especificación de plantilla (con todas las versiones) por identificador de recurso

Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'

Obtiene información sobre la especificación de plantilla denominada "MyTemplateSpec" dentro del grupo de recursos "myRG" de la suscripción {subId}.

Nota: Todas las versiones de la especificación de plantilla estarán presentes en ". Propiedad Versions" del objeto devuelto.

Ejemplo 6: Obtener especificación de plantilla (versión específica) por identificador de recurso

Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'

Obtiene información sobre la versión "v1.0" de la especificación de plantilla denominada "MyTemplateSpec" dentro del grupo de recursos "myRG" de la suscripción {subId}.

Nota: El ". La propiedad Versions" del objeto devuelto contendrá solo la versión específica solicitada.

Parámetros

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre de la especificación de plantilla.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetTemplateSpecByNameParameterSet
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ListTemplateSpecsParameterSet
Posición:0
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceId

Identificador de recurso completo de la especificación de plantilla. Ejemplo: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Id

Conjuntos de parámetros

GetTemplateSpecByIdParameterSet
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Version

Versión de la especificación de plantilla.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetTemplateSpecByNameParameterSet
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
GetTemplateSpecByIdParameterSet
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Salidas

PSTemplateSpec