Stop-AzResourceGroupDeployment
Cancela uma implantação de grupo de recursos.
Sintaxe
Stop-AzResourceGroupDeployment
[-ResourceGroupName] <String>
[-Name] <String>
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Stop-AzResourceGroupDeployment
-Id <String>
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Stop-AzResourceGroupDeployment 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-AzResourceGroupDeployment. O cmdlet New-AzResource 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-AzResourceGroupDeployment 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
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...Parâmetros
-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: | AzContext, 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-AzResourceGroupDeployment.
| 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 |