Share via

Stop-AzResourceGroupDeployment

  • Referens
Modul:
Az.Resources

Avbryter en resursgruppsdistribution.

Syntax

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

Description

Cmdleten Stop-AzResourceGroupDeployment avbryter en Azure-resursgruppsdistribution som har startats men inte slutförts. För att stoppa en distribution måste distributionen ha ett ofullständigt etableringstillstånd, till exempel Etablering och inte ett slutfört tillstånd, till exempel Etablerad eller Misslyckad. En Azure-resurs är en användarhanterad entitet, till exempel en webbplats, databas eller databasserver. En resursgrupp är en samling resurser som distribueras som en enhet. Om du vill distribuera en resursgrupp använder du cmdleten New-AzResourceGroupDeployment. Cmdleten New-AzResource skapar en ny resurs, men den utlöser inte en resursgruppsdistributionsåtgärd som den här cmdleten kan stoppa. Den här cmdleten stoppar bara en distribution som körs. Använd parametern Namn för att stoppa en specifik distribution. Om du utelämnar parametern Namn söker Stop-AzResourceGroupDeployment efter en distribution som körs och stoppar den. Om cmdleten hittar fler än en distribution som körs misslyckas kommandot.

Exempel

Exempel 1: Starta och stoppa en resursgruppsdistribution

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

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

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

-Id

Anger ID för resursgruppsdistributionen som ska stoppas.

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Anger namnet på den resursgruppsdistribution som ska stoppas. Om du inte anger den här parametern söker den här cmdleten efter en distribution som körs i resursgruppen och stoppar den. Om fler än en distribution körs misslyckas kommandot. Om du vill hämta distributionsnamnet använder du cmdleten Get-AzResourceGroupDeployment.

Type:String
Aliases:DeploymentName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.

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

-ResourceGroupName

Anger namnet på resursgruppen. Den här cmdleten stoppar distributionen av resursgruppen som den här parametern anger.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

Utdata

Boolean