Udostępnij przez

Set-AzTemplateSpec

Moduł:
Az.Resources Module

Modyfikuje specyfikację szablonu.

Składnia

FromJsonStringParameterSet (Domyślne) 

Set-AzTemplateSpec
    [-Location <String>]
    [-Tag <Hashtable>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateByIdParameterSet 

Set-AzTemplateSpec
    [-ResourceId] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    [-Location <String>]
    [-Tag <Hashtable>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateVersionByIdFromJsonFileParameterSet 

Set-AzTemplateSpec
    [-ResourceId] <String>
    [-Version] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    -TemplateFile <String>
    [-Location <String>]
    [-Tag <Hashtable>]
    [-VersionDescription <String>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateVersionByIdFromJsonParameterSet 

Set-AzTemplateSpec
    [-ResourceId] <String>
    [-Version] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    -TemplateJson <String>
    [-Location <String>]
    [-Tag <Hashtable>]
    [-VersionDescription <String>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateByNameParameterSet 

Set-AzTemplateSpec
    [-ResourceGroupName] <String>
    [-Name] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    [-Location <String>]
    [-Tag <Hashtable>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateVersionByNameFromJsonFileParameterSet 

Set-AzTemplateSpec
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Version] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    -TemplateFile <String>
    [-Location <String>]
    [-Tag <Hashtable>]
    [-VersionDescription <String>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateVersionByNameFromJsonParameterSet 

Set-AzTemplateSpec
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Version] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    -TemplateJson <String>
    [-Location <String>]
    [-Tag <Hashtable>]
    [-VersionDescription <String>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Modyfikuje specyfikację szablonu. Jeśli specyfikacja szablonu o określonej nazwie i/lub określonej wersji jeszcze nie istnieje, zostanie utworzona.

Podczas modyfikowania zawartości szablonu ARM wersji specyfikacji szablonu zawartość może pochodzić z nieprzetworzonego ciągu JSON (przy użyciu zestawu parametrów UpdateVersionByNameFromJsonParameterSet ) lub z określonego pliku JSON/Bicep (przy użyciu zestawu parametrów UpdateVersionByNameFromJsonFileParameterSet ).

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": []
}
"@
Set-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v1.0' -Location 'West US' -TemplateJson $templateJson

Modyfikuje wersję "v1.0" specyfikacji szablonu o nazwie "myTemplateSpec". Określona wersja będzie mieć $templateJson jako zawartość szablonu arm wersji. Jeśli główna specyfikacja i/lub wersja szablonu nie istnieją, zostaną utworzone.

Uwagi:

  • Szablon usługi ARM w przykładzie jest no-op, ponieważ nie zawiera żadnych rzeczywistych zasobów.
  • Lokalizacja jest wymagana tylko wtedy, gdy specyfikacja szablonu jeszcze nie istnieje

Przykład 2

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

Modyfikuje wersję "v2.0" specyfikacji szablonu o nazwie "myTemplateSpec". Określona wersja będzie zawierać zawartość z pliku lokalnego "myTemplateContent.json" jako zawartość szablonu arm wersji. Jeśli główna specyfikacja i/lub wersja szablonu nie istnieją, zostaną utworzone.

Nuta: Lokalizacja jest wymagana tylko wtedy, gdy specyfikacja szablonu jeszcze nie istnieje

Przykład 3

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

Modyfikuje opis specyfikacji szablonu o nazwie "myTemplateSpec" w grupie zasobów "myRG". Jeśli specyfikacja szablonu jeszcze nie istnieje, zostanie utworzona.

Nuta: Lokalizacja jest wymagana tylko wtedy, gdy specyfikacja szablonu jeszcze nie istnieje

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Description

Opis specyfikacji szablonu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateByIdParameterSet
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonFileParameterSet
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonParameterSet
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateByNameParameterSet
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonFileParameterSet
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonParameterSet
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DisplayName

Nazwa wyświetlana specyfikacji szablonu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateByIdParameterSet
Pozycja:2
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonFileParameterSet
Pozycja:2
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonParameterSet
Pozycja:2
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateByNameParameterSet
Pozycja:2
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonFileParameterSet
Pozycja:2
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonParameterSet
Pozycja:2
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Location

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Name

Nazwa specyfikacji szablonu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateByNameParameterSet
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonFileParameterSet
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonParameterSet
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateByNameParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonFileParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ResourceId

W pełni kwalifikowany identyfikator zasobu specyfikacji szablonu. Przykład: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Id

Zbiory parametrów

UpdateByIdParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonFileParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Tag

Tabela skrótów tagów specyfikacji szablonu i/lub wersji

Właściwości parametrów

Typ:Hashtable
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Etykiety

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-TemplateFile

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:InputFile

Zbiory parametrów

UpdateVersionByIdFromJsonFileParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonFileParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-TemplateJson

Plik JSON szablonu usługi Azure Resource Manager.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateVersionByIdFromJsonParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-UIFormDefinitionFile

UIForm dla zasobu templatespec

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-UIFormDefinitionString

UIForm dla zasobu templatespec

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Version

Wersja specyfikacji szablonu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateVersionByIdFromJsonFileParameterSet
Pozycja:3
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonParameterSet
Pozycja:3
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonFileParameterSet
Pozycja:3
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonParameterSet
Pozycja:3
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-VersionDescription

Opis wersji.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateVersionByIdFromJsonFileParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByIdFromJsonParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonFileParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
UpdateVersionByNameFromJsonParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

Wyjść

PSTemplateSpec