Compartir a través de

Stop-AzResourceGroupDeployment

Módulo:
Az.Resources Module

Cancela una implementación de grupo de recursos.

Sintaxis

StopByResourceGroupDeploymentName (valor predeterminado) 

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

StopByResourceGroupDeploymentId 

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

Description

El cmdlet Stop-AzResourceGroupDeployment cancela una implementación de grupo de recursos de Azure que se ha iniciado pero no completado. Para detener una implementación, la implementación debe tener un estado de aprovisionamiento incompleto, como Aprovisionamiento y no un estado completado, como Aprovisionado o Erróneo. Un recurso de Azure es una entidad administrada por el usuario, como un sitio web, una base de datos o un servidor de bases de datos. Un grupo de recursos es una colección de recursos que se implementan como una unidad. Para implementar un grupo de recursos, use el cmdlet New-AzResourceGroupDeployment. El cmdlet New-AzResource crea un nuevo recurso, pero no desencadena una operación de implementación de grupo de recursos que este cmdlet puede detener. Este cmdlet detiene solo una implementación en ejecución. Use el parámetro Name para detener una implementación específica. Si omite el parámetro Name , Stop-AzResourceGroupDeployment busca una implementación en ejecución y la detiene. Si el cmdlet encuentra más de una implementación en ejecución, se produce un error en el comando.

Ejemplos

Ejemplo 1: Inicio y detención de una implementación 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

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

Especifica el identificador de la implementación del grupo de recursos que se va a detener.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:DeploymentId, ResourceId

Conjuntos de parámetros

StopByResourceGroupDeploymentId
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre de la implementación del grupo de recursos que se va a detener. Si no especifica este parámetro, este cmdlet busca una implementación en ejecución en el grupo de recursos y la detiene. Si encuentra más de una implementación en ejecución, se produce un error en el comando. Para obtener el nombre de la implementación, use el cmdlet Get-AzResourceGroupDeployment.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:NombreDelDespliegue

Conjuntos de parámetros

StopByResourceGroupDeploymentName
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Pre

Indica que este cmdlet considera las versiones de API de versión preliminar cuando determina automáticamente qué versión se va a usar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Especifica el nombre del grupo de recursos. Este cmdlet detiene la implementación del grupo de recursos que especifica este parámetro.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

StopByResourceGroupDeploymentName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Salidas

Boolean