Udostępnij za pośrednictwem

New-AzTemplateSpec

  • Odwołanie
Moduł:
Az.Resources

Tworzy nową specyfikację szablonu.

Składnia

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

Opis

Tworzy nową wersję specyfikacji szablonu z określoną zawartością szablonu usługi ARM. Zawartość może pochodzić z nieprzetworzonego ciągu JSON (przy użyciu zestawu parametrów FromJsonStringParameterSet) lub z określonego pliku JSON/Bicep (przy użyciu zestawu parametrów FromJsonFileParameterSet).

Jeśli główna specyfikacja szablonu jeszcze nie istnieje, zostanie utworzona wraz z wersją specyfikacji szablonu. Jeśli specyfikacja szablonu już istnieje o podanej nazwie, zostanie ona zaktualizowana i określona wersja zostanie zaktualizowana (wszystkie inne istniejące wersje zostaną zachowane).

Przykłady

Przykład 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

Tworzy nową wersję specyfikacji szablonu "v1.0" w specyfikacji szablonu o nazwie "myTemplateSpec". Określona wersja będzie mieć $templateJson jako zawartość szablonu arm wersji.

Uwaga: Szablon usługi ARM w przykładzie jest bez operacji, ponieważ nie zawiera żadnych rzeczywistych zasobów.

Przykład 2

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

Tworzy nową wersję specyfikacji szablonu "v2.0" w specyfikacji szablonu o nazwie "myTemplateSpec". Określona wersja będzie zawierać zawartość z pliku lokalnego "myTemplateContent.json" jako zawartość szablonu arm wersji.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

Opis specyfikacji szablonu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DisplayName

Nazwa wyświetlana specyfikacji szablonu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Force

Nie pytaj o potwierdzenie podczas zastępowania istniejącej wersji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Lokalizacja specyfikacji szablonu. Wymagane tylko wtedy, gdy specyfikacja szablonu jeszcze nie istnieje.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa specyfikacji szablonu.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Tabela skrótów tagów dla nowych zasobów specyfikacji szablonu.

Typ:Hashtable
Aliasy:Tags
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TemplateFile

Ścieżka pliku do lokalnego pliku szablonu usługi Azure Resource Manager JSON/Bicep.

Typ:String
Aliasy:InputFile
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-TemplateJson

Plik JSON szablonu usługi Azure Resource Manager.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UIFormDefinitionFile

UIForm dla zasobu templatespec

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UIFormDefinitionString

UIForm dla zasobu templatespec

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Version

Wersja specyfikacji szablonu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VersionDescription

Opis wersji.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

PSTemplateSpec