Compartilhar via

Stop-AzResourceGroupDeployment

Módulo:
Az.Resources Module

Cancela uma implantação de grupo de recursos.

Sintaxe

StopByResourceGroupDeploymentName (Padrão) 

Stop-AzResourceGroupDeployment
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StopByResourceGroupDeploymentId 

Stop-AzResourceGroupDeployment
    -Id <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Stop-AzResourceGroupDeployment 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 o 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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:DeploymentId, ResourceId

Conjuntos de parâmetros

StopByResourceGroupDeploymentId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:DeploymentName

Conjuntos de parâmetros

StopByResourceGroupDeploymentName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Pre

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

StopByResourceGroupDeploymentName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

Boolean