Get-AzTemplateSpec
Obtiene o enumera las especificaciones de plantilla
Sintaxis
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 |
Alias: | AzContext, AzureRmContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Nombre de la especificación de plantilla.
Tipo: | String |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-ResourceGroupName
Nombre del grupo de recursos.
Tipo: | String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-ResourceId
Identificador de recurso completo de la especificación de plantilla. Ejemplo: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Tipo: | String |
Alias: | Id |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Version
Versión de la especificación de plantilla.
Tipo: | String |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |