Sdílet prostřednictvím

Set-AzTemplateSpec

  • Reference
Modul:
Az.Resources

Upraví specifikaci šablony.

Syntaxe

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

Description

Upraví specifikaci templace. 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í UpdateVersionByNameFromJsonParameterSet sady parametrů) nebo ze zadaného souboru JSON/Bicep (pomocí UpdateVersionByNameFromJsonFileParameterSet sady parametrů).

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 k :

  • Š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í je vyžadováno 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í je vyžadováno pouze v případě, že specifikace šablony ještě neexistuje.

Parametry

-Confirm

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

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Popis specifikace šablony.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DisplayName

Zobrazovaný název specifikace šablony.

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Location

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Název specifikace šablony.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Název skupiny prostředků.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceId

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

Typ:String
Aliasy:Id
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Hashtable of tags for the template spec and/or version

Typ:Hashtable
Aliasy:Tags
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TemplateFile

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

Typ:String
Aliasy:InputFile
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TemplateJson

JSON šablony Azure Resource Manageru

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UIFormDefinitionFile

UIForm for the templatespec resource

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UIFormDefinitionString

UIForm for the templatespec resource

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Version

Verze specifikace šablony.

Typ:String
Position:3
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VersionDescription

Popis verze.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

PSTemplateSpec