Sdílet prostřednictvím


Stop-AzureRmResourceGroupDeployment

Zruší nasazení skupiny prostředků.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

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

Rutina Stop-AzureRmResourceGroupDeployment zruší nasazení skupiny prostředků Azure, které se spustilo, ale nedokončilo. Pokud chcete zastavit nasazení, musí mít nasazení neúplný stav zřizování, jako je zřizování, a ne dokončený stav, jako je Provisioned nebo Failed. Prostředek Azure je entita spravovaná uživatelem, jako je web, databáze nebo databázový server. Skupina prostředků je kolekce prostředků nasazených jako jednotka. K nasazení skupiny prostředků použijte rutinu New-AzureRmResourceGroupDeployment. Rutina New-AzureRmResource vytvoří nový prostředek, ale neaktivuje operaci nasazení skupiny prostředků, kterou může tato rutina zastavit. Tato rutina zastaví pouze jedno spuštěné nasazení. K zastavení konkrétního nasazení použijte parametr Name . Pokud parametr Name vynecháte, stop-AzureRmResourceGroupDeployment vyhledá spuštěné nasazení a zastaví ho. Pokud rutina najde více než jedno spuštěné nasazení, příkaz selže.

Příklady

Příklad 1: Spuštění a zastavení nasazení skupiny prostředků

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

Parametry

-ApiVersion

Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliases:cf
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Určuje ID nasazení skupiny prostředků, které se má zastavit.

Typ:String
Aliases:DeploymentId, ResourceId
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Určuje název nasazení skupiny prostředků, která se má zastavit. Pokud tento parametr nezadáte, tato rutina vyhledá spuštěné nasazení ve skupině prostředků a zastaví ho. Pokud najde více než jedno spuštěné nasazení, příkaz selže. Pokud chcete získat název nasazení, použijte rutinu Get-AzureRmResourceGroupDeployment.

Typ:String
Aliases:DeploymentName
Position:1
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Určuje název skupiny prostředků. Tato rutina zastaví nasazení skupiny prostředků, kterou tento parametr určuje.

Typ:String
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliases:wi
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Výstupy

Boolean