Partager via

Stop-AzResourceGroupDeployment

  • Référence
Module:
Az.Resources

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

Entrées

String

Sorties

Boolean