Stop-AzResourceGroupDeployment

  • Referentie
Module:
Az.Resources

Hiermee annuleert u de implementatie van een resourcegroep.

Syntax

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
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:AzContext, 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-AzResourceGroupDeployment 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

String

Uitvoerwaarden

Boolean