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


Stop-AzureRmResourceGroupDeployment

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

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

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

Описание

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

Примеры

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

PS C:\> New-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg -TemplateFile .\storage-account-create-azuredeploy.json -TemplateParameterFile .\storage-account-create-azuredeploy.parameters.json -AsJob

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

PS C:\> Stop-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg
True

PS C:\> Get-Job 1

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

Параметры

-ApiVersion

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

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

-Confirm

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

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

-DefaultProfile

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

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

-Id

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

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

-Name

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

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

-Pre

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

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

-ResourceGroupName

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

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

-WhatIf

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

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

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

None

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

Boolean