Condividi tramite


Set-AzTemplateSpec

Modifica una specifica di modello.

Sintassi

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>]

Descrizione

Modifica una specifica templace. Se la specifica di modello con il nome e/o la versione specifica specificata non esiste già, verrà creata.

Quando si modifica il contenuto del modello di Resource Manager di una versione specifica di modello, il contenuto può provenire da una stringa JSON non elaborata (usando il set di parametri UpdateVersionByNameFromJsonParameterSet ) o da un file JSON/Bicep specificato (usando UpdateVersionByNameFromJsonFileParameterSet set di parametri).

Esempio

Esempio 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 versione "v1.0" di una specifica di modello denominata "myTemplateSpec". La versione specificata avrà $templateJson come contenuto del modello di Resource Manager della versione. Se la specifica di modello radice e/o la versione non esistono già, verranno create.

Note:

  • Il modello di Resource Manager nell'esempio è senza operazioni perché non contiene risorse effettive.
  • La posizione è obbligatoria solo quando la specifica di modello non esiste già

Esempio 2

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

Modifica la versione "v2.0" di una specifica di modello denominata "myTemplateSpec". La versione specificata avrà il contenuto del file locale "myTemplateContent.json" come contenuto del modello arm della versione. Se la specifica di modello radice e/o la versione non esistono già, verranno create.

Nota: la posizione è obbligatoria solo quando la specifica di modello non esiste già

Esempio 3

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

Modifica la descrizione della specifica di modello denominata "myTemplateSpec" nel gruppo di risorse "myRG". Se la specifica di modello non esiste già, verrà creata.

Nota: la posizione è obbligatoria solo quando la specifica di modello non esiste già

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Descrizione della specifica di modello.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DisplayName

Nome visualizzato della specifica di modello.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Location

Posizione della specifica di modello. Obbligatorio solo se la specifica di modello non esiste già.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome della specifica di modello.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

Nome del gruppo di risorse.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceId

ID risorsa completo della specifica di modello. Esempio: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}

Tipo:String
Alias:Id
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Tag

Tabella hash dei tag per la specifica di modello e/o la versione

Tipo:Hashtable
Alias:Tags
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TemplateFile

Percorso del file nel file JSON/Bicep del modello di Azure Resource Manager locale.

Tipo:String
Alias:InputFile
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TemplateJson

JSON del modello di Azure Resource Manager.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-UIFormDefinitionFile

UiForm per la risorsa templatespec

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-UIFormDefinitionString

UiForm per la risorsa templatespec

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Version

Versione della specifica di modello.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VersionDescription

Descrizione della versione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Output

PSTemplateSpec