Freigeben über

New-AzTemplateSpec

  • Referenz
Modul:
Az.Resources

Erstellt eine neue Vorlagenspezifikation.

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

Beschreibung

Erstellt eine neue Vorlagenspezifikationsversion mit dem angegebenen ARM-Vorlageninhalt. Der Inhalt kann entweder aus einer unformatierten JSON-Zeichenfolge (mit fromJsonStringParameterSet-Parametersatz ) oder aus einer angegebenen JSON/Bicep-Datei (mithilfe des FromJsonFileParameterSet-Parametersatzes ) stammen.

Wenn die Stammvorlagenspezifikation noch nicht vorhanden ist, wird sie zusammen mit der Vorlagenspezifikationsversion erstellt. Wenn bereits eine Vorlagenspezifikation mit dem angegebenen Namen vorhanden ist, wird sie und die angegebene Version aktualisiert (alle anderen vorhandenen Versionen bleiben erhalten).

Beispiele

Beispiel 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

Erstellt eine neue Vorlagenspezifikationsversion "v1.0" in einer Vorlagenspezifikation namens "myTemplateSpec". Die angegebene Version weist $templateJson als ARM-Vorlageninhalt der Version auf.

Hinweis: Die ARM-Vorlage im Beispiel ist eine No-Op, da sie keine tatsächlichen Ressourcen enthält.

Beispiel 2

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

Erstellt eine neue Vorlagenspezifikationsversion "v2.0" in einer Vorlagenspezifikation namens "myTemplateSpec". Die angegebene Version enthält den Inhalt der lokalen Datei "myTemplateContent.json" als ARM-Vorlageninhalt der Version.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Die Beschreibung der Vorlagenspezifikation.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DisplayName

Der Anzeigename der Vorlagenspezifikation.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Force

Fordern Sie beim Überschreiben einer vorhandenen Version keine Bestätigung an.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Der Speicherort der Vorlagenspezifikation. Nur erforderlich, wenn die Vorlagenspezifikation noch nicht vorhanden ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Der Name der Vorlagenspezifikation.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tag

Hashtabelle von Tags für die neuen Vorlagenspezifikationsressource(n).

Typ:Hashtable
Aliase:Tags
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TemplateFile

Der Dateipfad zur lokalen JSON/Bicep-Vorlage der Azure Resource Manager-Vorlage.

Typ:String
Aliase:InputFile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TemplateJson

Die Azure Resource Manager-Vorlage JSON.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-UIFormDefinitionFile

UIForm für die Templatespec-Ressource

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-UIFormDefinitionString

UIForm für die Templatespec-Ressource

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Version

Die Version der Vorlagenspezifikation.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VersionDescription

Die Beschreibung der Version.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Ausgaben

PSTemplateSpec