Stop-AzResourceGroupDeployment
Annule un déploiement de groupe de ressources.
Syntaxe
Stop-AzResourceGroupDeployment
[-ResourceGroupName] <String>
[-Name] <String>
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Stop-AzResourceGroupDeployment
-Id <String>
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Stop-AzResourceGroupDeployment annule un déploiement de groupe de ressources Azure qui a démarré, mais qui n’est pas 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é. Une ressource Azure est une entité gérée par l’utilisateur, telle qu’un site web, une base de données ou un serveur de base de données. Un groupe de ressources est une collection de ressources déployées en tant qu’unité. Pour déployer un groupe de ressources, utilisez l’applet de commande New-AzResourceGroupDeployment. L’applet de commande New-AzResource crée une ressource, mais elle ne déclenche pas d’opération de déploiement de groupe de ressources que cette applet de commande peut arrêter. 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. Si vous omettez le paramètre Name , Stop-AzResourceGroupDeployment recherche un déploiement en cours d’exécution et l’arrête. Si l’applet de commande trouve plusieurs déploiements en cours d’exécution, la commande échoue.
Exemples
Exemple 1 : Démarrage et arrêt d’un déploiement de groupe de ressources
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...Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure
| Type: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Id
Spécifie l’ID du déploiement du groupe de ressources à arrêter.
| Type: | String |
| Alias: | DeploymentId, ResourceId |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom du déploiement du groupe de ressources à arrêter. Si vous ne spécifiez pas ce paramètre, cette applet de commande recherche un déploiement en cours d’exécution dans le groupe de ressources et l’arrête. S’il trouve plusieurs déploiements en cours d’exécution, la commande échoue. Pour obtenir le nom du déploiement, utilisez l’applet de commande Get-AzResourceGroupDeployment.
| Type: | String |
| Alias: | DeploymentName |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Pre
Indique que cette applet de commande prend en compte les versions d’API en préversion lorsqu’elle détermine automatiquement la version à utiliser.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources. Cette applet de commande arrête le déploiement du groupe de ressources spécifié par ce paramètre.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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 |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
