Stop-AzureRmResourceGroupDeployment
Cancela uma implantação de grupo de recursos.
Aviso
O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Sintaxe
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>] Description
O cmdlet Stop-AzureRmResourceGroupDeployment cancela uma implantação de grupo de recursos do Azure que foi iniciada, mas não concluída. Para interromper uma implantação, a implantação deve ter um estado de provisionamento incompleto, como Provisionamento, e não um estado concluído, como Provisionado ou Falha. Um recurso do Azure é uma entidade gerenciada pelo usuário, como um site, banco de dados ou servidor de banco de dados. Um grupo de recursos é uma coleção de recursos implantados como uma unidade. Para implantar um grupo de recursos, use o cmdlet New-AzureRmResourceGroupDeployment. O cmdlet New-AzureRmResource cria um novo recurso, mas não dispara uma operação de implantação de grupo de recursos que esse cmdlet pode interromper. Esse cmdlet interrompe apenas uma implantação em execução. Use o parâmetro Name para interromper uma implantação específica. Se você omitir o parâmetro Name , Stop-AzureRmResourceGroupDeployment procurará uma implantação em execução e a interromperá. Se o cmdlet encontrar mais de uma implantação em execução, o comando falhará.
Exemplos
Exemplo 1: Iniciando e interrompendo uma implantação de grupo de recursos
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...Parâmetros
-ApiVersion
Especifica a versão da API compatível com o provedor de recursos. Você pode especificar uma versão diferente da versão padrão.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Id
Especifica a ID da implantação do grupo de recursos a ser interrompida.
| Tipo: | String |
| Aliases: | DeploymentId, ResourceId |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifica o nome da implantação do grupo de recursos a ser interrompida. Se você não especificar esse parâmetro, esse cmdlet procurará uma implantação em execução no grupo de recursos e a interromperá. Se encontrar mais de uma implantação em execução, o comando falhará. Para obter o nome da implantação, use o cmdlet Get-AzureRmResourceGroupDeployment.
| Tipo: | String |
| Aliases: | DeploymentName |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Pre
Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos. Esse cmdlet interrompe a implantação do grupo de recursos especificado por esse parâmetro.
| Tipo: | String |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None