Dela via


Stop-AzResourceGroupDeployment

Avbryter en resursgruppsdistribution.

Syntax

StopByResourceGroupDeploymentName (Standard)

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

StopByResourceGroupDeploymentId

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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

Anger ID för resursgruppsdistributionen som ska stoppas.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:DeploymentId, ResourceId

Parameteruppsättningar

StopByResourceGroupDeploymentId
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Distribueringsnamn

Parameteruppsättningar

StopByResourceGroupDeploymentName
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceGroupName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

StopByResourceGroupDeploymentName
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Utdata

Boolean