Compartir a través de


Get-AzTemplateSpec

Obtiene o enumera las especificaciones de plantilla

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

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 parámetros -Name o -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.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nombre de la especificación de plantilla.

Tipo:String
Position:1
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

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

Tipo:String
Aliases:Id
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

Versión de la especificación de plantilla.

Tipo:String
Position:2
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Salidas

PSTemplateSpec