Stop-AzResourceGroupDeployment

  • Ссылка
Модуль:
Az.Resources

Отменяет развертывание группы ресурсов.

Синтаксис

Stop-AzResourceGroupDeployment
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzResourceGroupDeployment
    -Id <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Stop-AzResourceGroupDeployment отменяет развертывание группы ресурсов Azure, которое началось, но не завершено. Чтобы остановить развертывание, развертывание должно иметь неполное состояние подготовки, например подготовка, а не завершенное состояние, например "Подготовка" или "Сбой". Ресурс Azure — это управляемая пользователем сущность, например веб-сайт, база данных или сервер баз данных. Группа ресурсов — это коллекция ресурсов, развернутых как единица. Чтобы развернуть группу ресурсов, используйте командлет New-AzResourceGroupDeployment. Командлет New-AzResource создает новый ресурс, но не активирует операцию развертывания группы ресурсов, которую этот командлет может остановить. Этот командлет останавливает только одно запущенное развертывание. Используйте параметр Name для остановки определенного развертывания. Если опустить параметр Name , Stop-AzResourceGroupDeployment ищет запущенное развертывание и останавливает его. Если командлет находит несколько запущенных развертываний, команда завершается ошибкой.

Примеры

Пример 1. Запуск и остановка развертывания группы ресурсов

New-AzResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg -TemplateFile .\storage-account-create-azdeploy.json -TemplateParameterFile .\storage-account-create-azdeploy.parameters.json -AsJob

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Long Running... AzureLongRun... Running       True            localhost            New-AzResourceGro...

Stop-AzResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg

True

Get-Job 1

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Long Running... AzureLongRun... Failed        True            localhost            New-AzResourceGro...

Параметры

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Указывает идентификатор развертывания группы ресурсов для остановки.

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Указывает имя развертывания группы ресурсов для остановки. Если этот параметр не указан, этот командлет выполняет поиск запущенного развертывания в группе ресурсов и останавливает его. Если он находит несколько запущенных развертываний, команда завершается ошибкой. Чтобы получить имя развертывания, используйте командлет Get-AzResourceGroupDeployment.

Type:String
Aliases:DeploymentName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Указывает, что этот командлет рассматривает версии API предварительной версии, когда она автоматически определяет, какую версию следует использовать.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Указывает имя группы ресурсов. Этот командлет останавливает развертывание группы ресурсов, указанной этим параметром.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

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

Boolean