Stop-AzureRmDeployment

Module:

AzureRM.Resources

Cancal a running deployment

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntax

Stop-AzureRmDeployment
    [-Name] <String>
    [-PassThru]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-AzureRmDeployment
    -Id <String>
    [-PassThru]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-AzureRmDeployment
    -InputObject <PSDeployment>
    [-PassThru]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Stop-AzureRmDeployment annule un déploiement au niveau de l’étendue de l’abonnement qui a démarré, mais qui n’a pas été terminé. Pour arrêter un déploiement, le déploiement doit avoir un état d’approvisionnement incomplet, tel que l’approvisionnement et non un état terminé, tel que Provisionné ou Échoué.

Pour créer un déploiement dans l’étendue de l’abonnement, utilisez l’applet de commande New-AzureRmDeployment.

Cette applet de commande arrête un seul déploiement en cours d’exécution. Utilisez le paramètre Name pour arrêter un déploiement spécifique.

Exemples

Exemple 1

PS C:\>Stop-AzureRmDeployment -Name "deployment01"

Cette commande annule un déploiement en cours d’exécution « deployment01 » dans l’étendue de l’abonnement actuel.

Exemple 2

PS C:\>Get-AzureRmDeployment -Name "deployment01" | Stop-AzureRmDeployment

Cette commande obtient le déploiement « deployment01 » dans l’étendue de l’abonnement actuel et l’annule.

Paramètres

-ApiVersion

Quand elle est définie, indique la version de l’API du fournisseur de ressources à utiliser. Si elle n’est pas spécifiée, la version de l’API est automatiquement déterminée comme la dernière version disponible.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

ID de ressource complet du déploiement. Exemple : /subscriptions/{subId}/providers/Microsoft.Resources/deployments/{deploymentName}

Type:	String
Aliases:	DeploymentId, ResourceId
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Objet de déploiement.

Type:	PSDeployment
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Le nom du déploiement.

Type:	String
Aliases:	DeploymentName
Position:	0
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

{{Fill PassThru Description}}

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Pre

Quand elle est définie, indique que l’applet de commande doit utiliser des versions d’API en préversion lors de la détermination automatique de la version à utiliser.

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

String

Sorties

Boolean