Dela via


Stop-AzureRmResourceGroupDeployment

Avbryter en resursgruppsdistribution.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Stop-AzureRmResourceGroupDeployment 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-AzureRmResourceGroupDeployment. Cmdleten New-AzureRmResource 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-AzureRmResourceGroupDeployment 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

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

Parametrar

-ApiVersion

Anger den API-version som stöds av resursprovidern. Du kan ange en annan version än standardversionen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger ID för resursgruppsdistributionen som ska stoppas.

Typ:String
Alias:DeploymentId, ResourceId
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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-AzureRmResourceGroupDeployment.

Typ:String
Alias:DeploymentName
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

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

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

Boolean