Dela 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 Name för att stoppa en specifik distribution. Om du utelämnar parametern Name 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.

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

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

String

Utdata

Boolean