Compartilhar via

Stop-AzResourceGroupDeployment

  • Referência
Módulo:
Az.Resources

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 do cancela uma implantação do grupo de recursos do Azure 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 Com Falha. Um recurso do Azure é uma entidade gerenciada pelo usuário, como um site, um banco de dados ou um servidor de banco de dados. Um grupo de recursos é uma coleção de recursos que são 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 parar. 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 a 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 usados 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 o 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

Entradas

String

Saídas

Boolean