Set-AzTemplateSpec

Upraví specifikaci šablony.

Syntax

FromJsonStringParameterSet (Výchozí)

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

UpdateByIdParameterSet

Set-AzTemplateSpec
    [-ResourceId] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    [-Location <String>]
    [-Tag <Hashtable>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

UpdateByNameParameterSet

Set-AzTemplateSpec
    [-ResourceGroupName] <String>
    [-Name] <String>
    [[-Description] <String>]
    [[-DisplayName] <String>]
    [-Location <String>]
    [-Tag <Hashtable>]
    [-UIFormDefinitionFile <String>]
    [-UIFormDefinitionString <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Description

Upraví specifikaci šablony. Pokud specifikace šablony se zadaným názvem nebo konkrétní verzí ještě neexistuje, vytvoří se.

Při úpravě obsahu šablony ARM verze šablony ARM může obsah pocházet z nezpracovaného řetězce JSON (pomocí UpdateVersionByFromJsonParameterSet sady parametrů) nebo ze zadaného souboru JSON/Bicep (pomocí sady parametrů UpdateVersionByNameFromJsonFileParameterSet).

Příklady

Příklad 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

Upraví verzi v1.0 specifikace šablony s názvem myTemplateSpec. Zadaná verze bude mít $templateJson jako obsah šablony ARM verze. Pokud specifikace kořenové šablony nebo verze ještě neexistují, vytvoří se.

Poznámky:

  • Šablona ARM v příkladu je no-op, protože neobsahuje žádné skutečné prostředky.
  • Umístění se vyžaduje pouze v případě, že specifikace šablony ještě neexistuje.

Příklad 2

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

Upraví verzi v2.0 specifikace šablony s názvem myTemplateSpec. Zadaná verze bude mít obsah z místního souboru "myTemplateContent.json" jako obsah šablony ARM verze. Pokud specifikace kořenové šablony nebo verze ještě neexistují, vytvoří se.

Poznámka: Umístění se vyžaduje pouze v případě, že specifikace šablony ještě neexistuje.

Příklad 3

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

Upraví popis specifikace šablony s názvem myTemplateSpec ve skupině prostředků myRG. Pokud specifikace šablony ještě neexistuje, vytvoří se.

Poznámka: Umístění se vyžaduje pouze v případě, že specifikace šablony ještě neexistuje.

Parametry

-AcquirePolicyToken

Získejte token Azure Policy automaticky pro tuto operaci prostředku.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ChangeReference

ID zdroje odkazu na změnu pro tuto operaci prostředku.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Description

Popis specifikace šablony.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateByIdParameterSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonFileParameterSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonParameterSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateByNameParameterSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonFileParameterSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonParameterSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DisplayName

Zobrazovaný název specifikace šablony.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateByIdParameterSet
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonFileParameterSet
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonParameterSet
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateByNameParameterSet
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonFileParameterSet
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonParameterSet
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Location

Umístění specifikace šablony. Vyžaduje se pouze v případě, že specifikace šablony ještě neexistuje.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

Název specifikace šablony.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateByNameParameterSet
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonFileParameterSet
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonParameterSet
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ResourceGroupName

Název skupiny zdrojů.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateByNameParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonFileParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ResourceId

Plně kvalifikované ID prostředku specifikace šablony. Příklad: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft. Prostředky/ templateSpecs/{templateSpecName}

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Id

Sady parametrů

UpdateByIdParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonFileParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Tag

Hashtable of tags for the template spec and/or version

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Štítky

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-TemplateFile

Cesta k souboru místní šablony Azure Resource Manager JSON/Bicep souboru.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:InputFile

Sady parametrů

UpdateVersionByIdFromJsonFileParameterSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonFileParameterSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-TemplateJson

JSON šablony Azure Resource Manager.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateVersionByIdFromJsonParameterSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonParameterSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-UIFormDefinitionFile

UIForm for the templatespec resource

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-UIFormDefinitionString

UIForm for the templatespec resource

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Version

Verze specifikace šablony.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateVersionByIdFromJsonFileParameterSet
Position:3
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonParameterSet
Position:3
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonFileParameterSet
Position:3
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonParameterSet
Position:3
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-VersionDescription

Popis verze.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

UpdateVersionByIdFromJsonFileParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByIdFromJsonParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonFileParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
UpdateVersionByNameFromJsonParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Výstupy

PSTemplateSpec