Compartir a través de


Stop-AzDeployment

Cancelación de una implementación en ejecución

Sintaxis

Stop-AzDeployment
    [-Name] <String>
    [-PassThru]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzDeployment
    -Id <String>
    [-PassThru]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzDeployment
    -InputObject <PSDeployment>
    [-PassThru]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Stop-AzDeployment cancela una implementación en el ámbito de la suscripción 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.

Para crear una implementación en el ámbito de la suscripción, use el cmdlet New-AzDeployment.

Este cmdlet detiene solo una implementación en ejecución. Use el parámetro Name para detener una implementación específica.

Ejemplos

Ejemplo 1

Stop-AzDeployment -Name "deployment01"

Este comando cancela una implementación en ejecución "deployment01" en el ámbito de la suscripción actual.

Ejemplo 2

Get-AzDeployment -Name "deployment01" | Stop-AzDeployment

Este comando obtiene la implementación "deployment01" en el ámbito de suscripción actual y la cancela.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Identificador de recurso completo de la implementación. ejemplo: /subscriptions/{subId}/providers/Microsoft.Resources/deployments/{deploymentName}

Tipo:String
Alias:DeploymentId, ResourceId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Objeto de implementación.

Tipo:PSDeployment
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Nombre de la implementación.

Tipo:String
Alias:DeploymentName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

{{Fill PassThru Description}}

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Pre

Cuando se establece, indica que el cmdlet debe usar versiones de API de versión preliminar al determinar automáticamente qué versión se va a usar.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSDeployment

Salidas

Boolean