Compartir a través de

Set-AzTemplateSpec

  • Referencia
Módulo:
Az.Resources

Modifica una especificación de plantilla.

Syntax

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
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:1
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:2
valor predeterminado:None
Requerido:False
Accept pipeline input:True
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

-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

-Tag

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

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:3
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

String

Salidas

PSTemplateSpec