New-AzTemplateSpec
Erstellt eine neue Vorlagenspezifikation.
Syntax
FromJsonStringParameterSet (Standard)
New-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
-Version <String>
-TemplateJson <String>
[-Description <String>]
[-DisplayName <String>]
[-Location <String>]
[-Tag <Hashtable>]
[-VersionDescription <String>]
[-Force]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromJsonFileParameterSet
New-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
-Version <String>
-TemplateFile <String>
[-Description <String>]
[-DisplayName <String>]
[-Location <String>]
[-Tag <Hashtable>]
[-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.
Anmerkung: 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 aus der lokalen Datei "myTemplateContent.json" als ARM-Vorlageninhalt der Version.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: vgl
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-Description
Die Beschreibung der Vorlagenspezifikation.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-DisplayName
Der Anzeigename der Vorlagenspezifikation.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Force
Fordern Sie beim Überschreiben einer vorhandenen Version keine Bestätigung an.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-Location
Der Speicherort der Vorlagenspezifikation. Nur erforderlich, wenn die Vorlagenspezifikation noch nicht vorhanden ist.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Name
Der Name der Vorlagenspezifikation.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: 1
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Der Name der Ressourcengruppe.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: 0
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Tag
Hashtabelle von Tags für die neuen Vorlagenspezifikationsressource(n).
Parametereigenschaften
Typ: Hashtable
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: Stichwörter
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-TemplateFile
Der Dateipfad zur lokalen JSON/Bicep-Vorlage der Azure Resource Manager-Vorlage.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: InputFile
Parametersätze
FromJsonFileParameterSet
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-TemplateJson
Die Azure Resource Manager-Vorlage JSON.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
FromJsonStringParameterSet
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
UIForm für die Templatespec-Ressource
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
UIForm für die Templatespec-Ressource
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Version
Die Version der Vorlagenspezifikation.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-VersionDescription
Die Beschreibung der Version.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: Wi
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben