Delen via


Stop-AzResourceGroupDeployment

Hiermee annuleert u de implementatie van een resourcegroep.

Syntaxis

Stop-AzResourceGroupDeployment
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzResourceGroupDeployment
    -Id <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

De cmdlet Stop-AzResourceGroupDeployment annuleert een Implementatie van een Azure-resourcegroep die is gestart, maar niet is voltooid. Als u een implementatie wilt stoppen, moet de implementatie een onvolledige inrichtingsstatus hebben, zoals Inrichten en geen voltooide status, zoals Ingericht of Mislukt. Een Azure-resource is een door de gebruiker beheerde entiteit, zoals een website, database of databaseserver. Een resourcegroep is een verzameling resources die als een eenheid worden geïmplementeerd. Als u een resourcegroep wilt implementeren, gebruikt u de cmdlet New-AzResourceGroupDeployment. De cmdlet New-AzResource maakt een nieuwe resource, maar activeert geen implementatiebewerking voor een resourcegroep die door deze cmdlet kan worden gestopt. Met deze cmdlet wordt slechts één actieve implementatie gestopt. Gebruik de parameter Name om een specifieke implementatie te stoppen. Als u de parameter Name weglaat, zoekt Stop-AzResourceGroupDeployment naar een actieve implementatie en stopt u deze. Als de cmdlet meer dan één actieve implementatie vindt, mislukt de opdracht.

Voorbeelden

Voorbeeld 1: Een implementatie van een resourcegroep starten en stoppen

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...

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u de id van de implementatie van de resourcegroep op die moet worden gestopt.

Type:String
Aliassen:DeploymentId, ResourceId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de implementatie van de resourcegroep op die moet worden gestopt. Als u deze parameter niet opgeeft, zoekt deze cmdlet naar een actieve implementatie in de resourcegroep en stopt deze. Als er meer dan één actieve implementatie wordt gevonden, mislukt de opdracht. Gebruik de cmdlet Get-AzResourceGroupDeployment om de implementatienaam op te halen.

Type:String
Aliassen:DeploymentName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep. Deze cmdlet stopt de implementatie van de resourcegroep die met deze parameter wordt opgegeven.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

Boolean