Stop-AzResourceGroupDeployment

  • Référence
Module:
Az.Resources

Annule un déploiement de groupe de ressources.

Syntax

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
Aliases:cf
Position:Named
Default value:False
Required: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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Spécifie l’ID du déploiement du groupe de ressources à arrêter.

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:DeploymentName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
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
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Sorties

Boolean