Partilhar 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 cancela uma implantação de grupo de recursos do Azure que foi iniciada, mas não concluída. Para interromper uma implantação, ela deve ter um estado de provisionamento incompleto, como Provisionamento, e não um estado concluído, como Provisionado ou Falhado. 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 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 aciona uma operação de implantação de grupo de recursos que esse cmdlet possa parar. Este 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 sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

Especifica a ID da implantação do grupo de recursos a ser interrompida.

Tipo:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Pre

Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

Especifica o nome do grupo de recursos. Este cmdlet interrompe a implantação do grupo de recursos especificado por esse parâmetro.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

Boolean