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
UIForm для ресурса templatespec
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
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 .
Выходные данные