Set-AzTemplateSpec

Изменяет спецификацию шаблона.

Синтаксис

FromJsonStringParameterSet (По умолчанию)

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

Описание

Изменяет спецификацию шаблона. Если спецификация шаблона с указанным именем и /или определенной версией еще не существует, она будет создана.

При изменении содержимого шаблона ARM версии спецификации шаблона Содержимое может поступать из необработанной строки JSON (с помощью UpdateVersionByNameFromJsonParameterSet набора параметров) или из указанного файла JSON/Bicep (с помощью набора параметров UpdateVersionByNameFromJsonFileParameterSet).

Примеры

Пример 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

Изменяет версию "v1.0" спецификации шаблона с именем myTemplateSpec. Указанная версия будет иметь $templateJson в качестве содержимого шаблона ARM версии. Если корневая спецификация шаблона и (или) версия еще не существует, они будут созданы.

Примечания:

  • Шаблон ARM в примере — это no-op, так как он не содержит фактических ресурсов.
  • Расположение требуется только в том случае, если спецификация шаблона еще не существует

Пример 2

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

Изменяет версию "v2.0" спецификации шаблона с именем myTemplateSpec. Указанная версия будет содержать содержимое из локального файла "myTemplateContent.json" в качестве содержимого шаблона ARM версии. Если корневая спецификация шаблона и (или) версия еще не существует, они будут созданы.

Заметка: Расположение требуется только в том случае, если спецификация шаблона еще не существует

Пример 3

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

Изменяет описание спецификации шаблона с именем myTemplateSpec в группе ресурсов myRG. Если спецификация шаблона еще не существует, она будет создана.

Заметка: Расположение требуется только в том случае, если спецификация шаблона еще не существует

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Свойства параметров

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

Описание спецификации шаблона.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateByIdParameterSet
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonFileParameterSet
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonParameterSet
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateByNameParameterSet
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonFileParameterSet
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonParameterSet
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisplayName

Отображаемое имя спецификации шаблона.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateByIdParameterSet
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonFileParameterSet
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonParameterSet
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateByNameParameterSet
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonFileParameterSet
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonParameterSet
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Location

Расположение спецификации шаблона. Требуется только в том случае, если спецификация шаблона еще не существует.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

Имя спецификации шаблона.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateByNameParameterSet
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonFileParameterSet
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonParameterSet
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceGroupName

Имя группы ресурсов.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateByNameParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonFileParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceId

Полный идентификатор ресурса спецификации шаблона. Пример: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Майкрософт. Resources/templateSpecs/{templateSpecName}

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Id

Наборы параметров

UpdateByIdParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonFileParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tag

Хэширование тегов для спецификации шаблона и (или) версии

Свойства параметров

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Метки

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TemplateFile

Путь к файлу локального Azure Resource Manager шаблона JSON/Bicep.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:InputFile

Наборы параметров

UpdateVersionByIdFromJsonFileParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonFileParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-TemplateJson

Json Azure Resource Manager шаблона.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateVersionByIdFromJsonParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-UIFormDefinitionFile

UIForm для ресурса templatespec

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-UIFormDefinitionString

UIForm для ресурса templatespec

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Version

Версия спецификации шаблона.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateVersionByIdFromJsonFileParameterSet
Position:3
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonParameterSet
Position:3
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonFileParameterSet
Position:3
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonParameterSet
Position:3
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-VersionDescription

Описание версии.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateVersionByIdFromJsonFileParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByIdFromJsonParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonFileParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
UpdateVersionByNameFromJsonParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Выходные данные

PSTemplateSpec