Stop-AzureRmResourceGroupDeployment
Cancela una implementación de grupo de recursos.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Syntax
Stop-AzureRmResourceGroupDeployment
[-ResourceGroupName] <String>
[-Name] <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-AzureRmResourceGroupDeployment
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Stop-AzureRmResourceGroupDeployment 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-AzureRmResourceGroupDeployment. El cmdlet New-AzureRmResource 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-AzureRmResourceGroupDeployment 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
PS C:\> New-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg -TemplateFile .\storage-account-create-azuredeploy.json -TemplateParameterFile .\storage-account-create-azuredeploy.parameters.json -AsJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Long Running... AzureLongRun... Running True localhost New-AzureRmResourceGro...
PS C:\> Stop-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg
True
PS C:\> Get-Job 1
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Long Running... AzureLongRun... Failed True localhost New-AzureRmResourceGro...
Parámetros
-ApiVersion
Especifica la versión de API compatible con el proveedor de recursos. Puede especificar una versión diferente de la versión predeterminada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica el identificador de la implementación del grupo de recursos que se va a detener.
Type: | String |
Aliases: | DeploymentId, ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 implementación, use el cmdlet Get-AzureRmResourceGroupDeployment.
Type: | String |
Aliases: | DeploymentName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos. Este cmdlet detiene la implementación del grupo de recursos que especifica este parámetro.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None