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