Поделиться через


Set-AzSubscriptionDeploymentStack

Задает новый стек развертывания область подписки.

Синтаксис

Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSubscriptionDeploymentStack
   -Name <String>
   [-Description <String>]
   -Location <String>
   [-DeploymentResourceGroupName <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Обновите стек развертывания область подписки.

Примеры

Пример 1. Обновления стек развертывания область подписки MySubStack в текущей подписке

Set-AzSubscriptionDeploymentStack -Name MySubStack -TemplateFile myTemplate.json -Location westus -DenySettingsMode DenyDelete

Обновите стек развертывания область подписки с именем MySubStack по умолчанию, а параметры запрета — DenyDelete.

Пример 2. Использование Bicepparam-файла для обновления стека

Set-AzSubscriptionDeploymentStack -Name MySubStack -Location westus -DenySettingsMode DenyDelete -TemplateParameterFile "./parameters.bicepparam"

Эта команда обновляет стек в подписке область с помощью файла Bicepparam на диске.

Параметры

-ActionOnUnmanage

Действия по принятию ресурсов, которые становятся неуправляемыми при удалении или обновлении стека развертывания. Возможные значения: "detachAll" (не удаляйте неуправляемые ресурсы), deleteResources (удалите все неуправляемые ресурсы, которые не являются RG или MG), и deleteAll (удалите каждый неуправляемый ресурс).

Тип:PSActionOnUnmanage
Допустимые значения:DetachAll, DeleteResources, DeleteResourcesAndResourceGroups, DeleteAll
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AsJob

Запустите командлет в фоновом режиме.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BypassStackOutOfSyncError

Обходить ошибки для стека, не синхронизированного при выполнении операции. Если стек не синхронизирован и этот параметр не задан, операция завершится ошибкой. Включите этот параметр только в том случае, если он будет указан для операции сбоем стека.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-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

-DenySettingsApplyToChildScopes

Применяется к дочерним область.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DenySettingsExcludedAction

Список операций управления на основе ролей, исключенных из запрета Параметры. Разрешено до 200 действий.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DenySettingsExcludedPrincipal

Список идентификаторов субъектов AAD, исключенных из блокировки. Разрешено до 5 субъектов.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DenySettingsMode

Режим запрета Параметры. Возможные значения включают: "denyDelete", "denyWriteAndDelete" и "none".

Тип:PSDenySettingsMode
Допустимые значения:None, DenyDelete, DenyWriteAndDelete
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeploymentResourceGroupName

ResourceGroup, в которой будет создано развертывание. Если ни один из них не указан, он по умолчанию будет использоваться на уровне подписки область стека развертывания.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Описание стека.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Force

Не запрашивайте подтверждение при перезаписи существующего стека.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Location

Расположение стека.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Имя создаваемого развертыванияStack.

Тип:String
Aliases:StackName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Pre

При установке указывает, что командлет должен использовать предварительно выпущенные версии API при автоматическом определении используемой версии.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-QueryString

Строка запроса (например, маркер SAS), используемая с параметром TemplateUri. Будет использоваться в случае связанных шаблонов

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipTemplateParameterPrompt

Пропускает динамическую обработку параметров PowerShell, которая проверка, если указанный параметр шаблона содержит все необходимые параметры, используемые шаблоном. Это проверка предложит пользователю предоставить значение отсутствующих параметров, но если параметр не был привязан к шаблону, то при условии, что параметр -SkipTemplateParameterPrompt будет игнорировать этот запрос и ошибку немедленно, если параметр не был привязан к шаблону. Для неинтерактивных скриптов можно предоставить -SkipTemplateParameterPrompt, чтобы предоставить лучшее сообщение об ошибке в случае, если не все необходимые параметры удовлетворены.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Tag

Теги, которые необходимо поместить в развертывание.

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TemplateFile

TemplateFile, используемый для создания стека.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TemplateParameterFile

Файл параметров, используемый для шаблона.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TemplateParameterObject

Хэш-таблица, представляющая параметры.

Тип:Hashtable
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TemplateParameterUri

Расположение файла параметров, используемого для шаблона.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TemplateSpecId

ResourceId шаблонаSpec, который будет использоваться для создания стека.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TemplateUri

Расположение шаблона, используемого для создания стека.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

String

Hashtable

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

PSDeploymentStack