Set-AzTemplateSpec
Изменяет спецификацию шаблона.
Синтаксис
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>]
Описание
Изменяет спецификацию Templace. Если спецификация шаблона с указанным именем и /или определенной версией еще не существует, она будет создана.
При изменении содержимого шаблона ARM версии спецификации шаблона ARM содержимое может поступать из необработанной строки JSON (используя UpdateVersionByNameFromJsonParameterSet набор параметров) или из указанного файла JSON/Bicep (с помощью набора параметров UpdateVersionVersionByNameFromJsonFileParameterSet).
Примеры
Пример 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
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Description
Описание спецификации шаблона.
Тип: | String |
Position: | 1 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-DisplayName
Отображаемое имя спецификации шаблона.
Тип: | String |
Position: | 2 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Location
Расположение спецификации шаблона. Требуется только в том случае, если спецификация шаблона еще не существует.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Name
Имя спецификации шаблона.
Тип: | String |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ResourceGroupName
Имя группы ресурсов.
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ResourceId
Полный идентификатор ресурса спецификации шаблона. Пример: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Тип: | String |
Aliases: | Id |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Tag
Хэширование тегов для спецификации шаблона и (или) версии
Тип: | Hashtable |
Aliases: | Tags |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TemplateFile
Путь к локальному файлу шаблона Azure Resource Manager JSON/Bicep.
Тип: | String |
Aliases: | InputFile |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-TemplateJson
JSON шаблона Azure Resource Manager.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-UIFormDefinitionFile
UIForm для ресурса templatespec
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-UIFormDefinitionString
UIForm для ресурса templatespec
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Version
Версия спецификации шаблона.
Тип: | String |
Position: | 3 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-VersionDescription
Описание версии.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Выходные данные
Azure PowerShell