共用方式為

Remove-AzureSubscription

  • 參考
模組:
Azure

從 Windows PowerShell 刪除 Azure 訂用帳戶。

注意

本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。

Syntax

Remove-AzureSubscription
      -SubscriptionName <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureSubscription
      -SubscriptionId <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-AzureSubscription Cmdlet 會從您的訂用帳戶資料檔案中刪除 Azure 訂用帳戶，讓 Windows PowerShell 找不到它。 此 Cmdlet 不會從 Microsoft Azure 刪除訂用帳戶，或以任何方式變更實際的訂用帳戶。

本主題描述 Microsoft Azure PowerShell 模組 0.8.10 版中的 Cmdlet。 若要取得您所使用的模組版本，請在 Azure PowerShell 主控台中輸入 (Get-Module -Name Azure).Version 。

範例

範例 1：刪除訂用帳戶

C:\PS> Remove-AzureSubscription -SubscriptionName Test

Confirm
Are you sure you want to perform this action?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

此命令會從預設訂用帳戶資料檔案中刪除 「Test」 訂用帳戶。

範例 2：從替代訂用帳戶資料檔案中刪除

C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force

此命令會從 MySubscriptions.xml 訂閱資料檔案中刪除測試訂閱。 命令會使用 Force 參數來隱藏確認提示。

範例 3：刪除腳本中的訂用帳戶

C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}

此命令會在 If 語句中使用 Remove-AzureSubscription 命令。 它會使用 PassThru 參數來傳回布林值，以判斷 If 語句中的 腳本區塊是否執行。

參數

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

隱藏確認提示。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

如果命令成功，並$False失敗，則傳回$True。 根據預設，此 Cmdlet 不會傳回任何輸出。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設設定檔讀取。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Type:String
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionName

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

您可以透過屬性名稱將輸入管線傳送至此 Cmdlet，但不能依值傳送。

輸出

None or System.Boolean

如果您使用 PassThru 參數，此 Cmdlet 會傳回布林值。 否則，它不會傳回任何輸出。