Stop-AzureRmDeployment

模組:

AzureRM.Resources

可調整執行中的部署

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

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

Stop-AzureRmDeployment Cmdlet 會取消已啟動但尚未完成的訂用帳戶範圍部署。 若要停止部署，部署必須具有不完整的布建狀態，例如布建，而不是已完成的狀態，例如已布建或失敗。

若要在訂用帳戶範圍建立部署，請使用 New-AzureRmDeployment Cmdlet。

此 Cmdlet 只會停止一個執行中的部署。 使用 Name 參數來停止特定部署。

範例

範例 1

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

此命令會取消目前訂用帳戶範圍的執行中部署 「deployment01」。。

範例 2

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

此命令會取得目前訂用帳戶範圍的部署 「deployment01」，並取消部署。

參數

-ApiVersion

設定時，表示要使用的資源提供者 API 版本。 如果未指定，API 版本會自動判斷為最新的可用版本。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

部署的完整資源標識碼。 範例：/subscriptions/{subId}/providers/Microsoft.Resources/deployments/{deploymentName}

類型:	String
別名:	DeploymentId, ResourceId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InputObject

部署物件。

類型:	PSDeployment
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

部署的名稱。

類型:	String
別名:	DeploymentName
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PassThru

{{Fill PassThru Description}}

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Pre

設定時，表示 Cmdlet 在自動判斷要使用的版本時，應該使用發行前版本 API 版本。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

輸出

Boolean