New-AzTemplateSpec
Crea una nueva especificación de plantilla.
Syntax
New-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
-Version <String>
[-Description <String>]
[-DisplayName <String>]
[-Location <String>]
[-Tag <Hashtable>]
-TemplateJson <String>
[-VersionDescription <String>]
[-Force]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
-Version <String>
[-Description <String>]
[-DisplayName <String>]
[-Location <String>]
[-Tag <Hashtable>]
-TemplateFile <String>
[-VersionDescription <String>]
[-Force]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Crea una nueva versión de especificación de plantilla con el contenido de la plantilla de ARM especificado. El contenido puede provenir de una cadena JSON sin formato (mediante fromJsonStringParameterSet establecido) o de un archivo JSON/Bicep especificado (mediante el conjunto de parámetros FromJsonFileParameterSet ).
Si la especificación de plantilla raíz aún no existe, se creará junto con la versión de especificación de plantilla. Si ya existe una especificación de plantilla con el nombre especificado, se actualizará la versión especificada (se conservarán otras versiones existentes).
Ejemplos
Ejemplo 1
$templateJson = @"
{
"$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"resources": []
}
"@
New-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v1.0' -Location 'West US' -TemplateJson $templateJson
Crea una nueva versión de especificación de plantilla "v1.0" en una especificación de plantilla denominada "myTemplateSpec". La versión especificada tendrá $templateJson como contenido de la plantilla de ARM de la versión.
Nota: La plantilla de ARM del ejemplo es una operación sin operación, ya que no contiene recursos reales.
Ejemplo 2
New-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v2.0' -Location 'West US' -TemplateFile 'myTemplateContent.json'
Crea una nueva versión de especificación de plantilla "v2.0" en una especificación de plantilla denominada "myTemplateSpec". La versión especificada tendrá el contenido del archivo local "myTemplateContent.json" como contenido de la plantilla de ARM de la versión.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-Description
Descripción de la especificación de plantilla.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayName
Nombre para mostrar de la especificación de plantilla.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
No pida confirmación al sobrescribir una versión existente.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Ubicación de la especificación de plantilla. Solo es necesario si la especificación de plantilla aún no existe.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
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 |
-Tag
Tabla hash de etiquetas para los nuevos recursos de especificación de plantilla.
Tipo: | Hashtable |
Aliases: | Tags |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateFile
Ruta de acceso del archivo al archivo JSON/Bicep de la plantilla local de Azure Resource Manager.
Tipo: | String |
Aliases: | InputFile |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateJson
Json de la plantilla de Azure Resource Manager.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UIFormDefinitionFile
UIForm para el recurso templatespec
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UIFormDefinitionString
UIForm para el recurso templatespec
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Versión de la especificación de plantilla.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VersionDescription
Descripción de la versión.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de