Stop-AzureRmResourceGroupDeployment

Hiermee annuleert u de implementatie van een resourcegroep.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

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

Description

De cmdlet Stop-AzureRmResourceGroupDeployment 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-AzureRmResourceGroupDeployment. Met de cmdlet New-AzureRmResource wordt een nieuwe resource gemaakt, maar er wordt geen implementatiebewerking voor een resourcegroep geactiveerd 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-AzureRmResourceGroupDeployment 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

PS C:\> New-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg -TemplateFile .\storage-account-create-azuredeploy.json -TemplateParameterFile .\storage-account-create-azuredeploy.parameters.json -AsJob

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Long Running... AzureLongRun... Running       True            localhost            New-AzureRmResourceGro...

PS C:\> Stop-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg
True

PS C:\> Get-Job 1

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Long Running... AzureLongRun... Failed        True            localhost            New-AzureRmResourceGro...

Parameters

-ApiVersion

Hiermee geeft u de API-versie op die wordt ondersteund door de resourceprovider. U kunt een andere versie opgeven dan de standaardversie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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-AzureRmResourceGroupDeployment om de implementatienaam op te halen.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

Uitvoerwaarden

Boolean