Compartir a través de


Set-AzTemplateSpec

Modifica una especificación de plantilla.

Sintaxis

Set-AzTemplateSpec
   [-Location <String>]
   [-Tag <Hashtable>]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzTemplateSpec
   [-ResourceId] <String>
   [[-Description] <String>]
   [[-DisplayName] <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzTemplateSpec
   [-ResourceId] <String>
   [-Version] <String>
   [[-Description] <String>]
   [[-DisplayName] <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   -TemplateFile <String>
   [-VersionDescription <String>]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzTemplateSpec
   [-ResourceId] <String>
   [-Version] <String>
   [[-Description] <String>]
   [[-DisplayName] <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   -TemplateJson <String>
   [-VersionDescription <String>]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzTemplateSpec
   [-ResourceGroupName] <String>
   [-Name] <String>
   [[-Description] <String>]
   [[-DisplayName] <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzTemplateSpec
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Version] <String>
   [[-Description] <String>]
   [[-DisplayName] <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   -TemplateFile <String>
   [-VersionDescription <String>]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzTemplateSpec
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Version] <String>
   [[-Description] <String>]
   [[-DisplayName] <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   -TemplateJson <String>
   [-VersionDescription <String>]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Modifica una especificación templace. Si la especificación de plantilla con el nombre especificado o la versión específica aún no existe, se creará.

Al modificar el contenido de una plantilla arm de la versión de la especificación de plantilla, el contenido puede proceder de una cadena JSON sin procesar (mediante updateVersionByNameFromJsonParameterSet establecido) o desde un archivo JSON/Bicep especificado (mediante updateVersionByNameFromJsonFileParameterSet establecido).

Ejemplos

Ejemplo 1

$templateJson = @"
{
    "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {},
    "resources": []
}
"@
Set-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v1.0' -Location 'West US' -TemplateJson $templateJson

Modifica la versión "v1.0" de una especificación de plantilla denominada "myTemplateSpec". La versión especificada tendrá $templateJson como contenido de la plantilla de ARM de la versión. Si la especificación de plantilla raíz o la versión aún no existen, se crearán.

Notas:

  • La plantilla de ARM del ejemplo es una operación sin operación, ya que no contiene recursos reales.
  • La ubicación solo es necesaria cuando la especificación de plantilla aún no existe.

Ejemplo 2

Set-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v2.0' -Location 'West US' -TemplateFile 'myTemplateContent.json'

Modifica la versión "v2.0" de 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. Si la especificación de plantilla raíz o la versión aún no existen, se crearán.

Nota: La ubicación solo es necesaria cuando la especificación de plantilla aún no existe

Ejemplo 3

Set-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec'  -Location 'West US' -Description 'My updated Template Spec'

Modifica la descripción de la especificación de plantilla denominada "myTemplateSpec" en el grupo de recursos "myRG". Si la especificación de plantilla aún no existe, se creará.

Nota: La ubicación solo es necesaria cuando la especificación de plantilla aún no existe

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-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

-Description

Descripción de la especificación de plantilla.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DisplayName

Nombre para mostrar 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

-Location

Ubicación de la especificación de plantilla. Solo es necesario si la especificación de plantilla aún no existe.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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

-Tag

Tabla hash de etiquetas para la especificación de plantilla y/o versión

Tipo:Hashtable
Alias:Tags
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TemplateFile

Ruta de acceso del archivo al archivo JSON/Bicep de la plantilla local de Azure Resource Manager.

Tipo:String
Alias:InputFile
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TemplateJson

Json de la plantilla de Azure Resource Manager.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UIFormDefinitionFile

UIForm para el recurso templatespec

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UIFormDefinitionString

UIForm para el recurso templatespec

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Version

Versión de la especificación de plantilla.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VersionDescription

Descripción de la versión.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Salidas

PSTemplateSpec