Sdílet prostřednictvím


Stop-AzureRmDeployment

Cancal a running deployment

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-AzureRmDeployment
    [-Name] <String>
    [-PassThru]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzureRmDeployment
    -Id <String>
    [-PassThru]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzureRmDeployment
    -InputObject <PSDeployment>
    [-PassThru]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Stop-AzureRmDeployment zruší nasazení v oboru předplatného, 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.

K vytvoření nasazení v oboru předplatného použijte rutinu New-AzureRmDeployment.

Tato rutina zastaví pouze jedno spuštěné nasazení. K zastavení konkrétního nasazení použijte parametr Name .

Příklady

Příklad 1

PS C:\>Stop-AzureRmDeployment -Name "deployment01"

Tento příkaz zruší spuštěné nasazení "deployment01" v aktuálním oboru předplatného.

Příklad 2

PS C:\>Get-AzureRmDeployment -Name "deployment01" | Stop-AzureRmDeployment

Tento příkaz získá nasazení "deployment01" v aktuálním oboru předplatného a zruší ho.

Parametry

-ApiVersion

Při nastavení označuje verzi rozhraní API poskytovatele prostředků, která se má použít. Pokud není zadána, verze rozhraní API se automaticky určí jako nejnovější dostupná.

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:None
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

Plně kvalifikované ID prostředku nasazení. příklad: /subscriptions/{subId}/providers/Microsoft.Resources/deployments/{deploymentName}

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

-InputObject

Objekt nasazení.

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

-Name

Název nasazení.

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

-PassThru

{{Fill PassThru Description}}

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

-Pre

Při nastavení označuje, že rutina by měla při automatickém určování verze, kterou verzi použít, používat předběžné verze rozhraní API.

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
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:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

String

Výstupy

Boolean