Get-AzureSubscription
取得 Azure 帳戶中的 Azure 訂用帳戶。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。
語法
Get-AzureSubscription
[-SubscriptionName <String>]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Get-AzureSubscription
[-SubscriptionId <String>]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Get-AzureSubscription
[-Default]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Get-AzureSubscription
[-Current]
[-ExtendedDetails]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Get-AzureSubscription Cmdlet 會取得 Azure 帳戶中的訂用帳戶。 您可以使用此 Cmdlet 來取得訂用帳戶的相關信息，並將訂用帳戶管線傳送至其他 Cmdlet。
Get-AzureSubscription 需要存取您的 Azure 帳戶。 執行 Get-AzureSubscription 之前，您必須先執行 Add-AzureAccount Cmdlet 或下載並安裝發行配置檔的 Cmdlet（Get-AzurePublishSettingsFile、Import-AzurePublishSettingsFile。
本主題描述 Microsoft Azure PowerShell 模組 0.8.10 版本中的 Cmdlet。
若要取得您所使用的模組版本，請在 Azure PowerShell 控制台中輸入 (Get-Module -Name Azure).Version。
範例
範例 1：取得所有訂用帳戶
C:\PS>Get-AzureSubscription此命令會取得帳戶中的所有訂用帳戶。
範例 2：依名稱取得訂用帳戶
C:\PS>Get-AzureSubscription -SubscriptionName "MyProdSubscription"此命令只會取得 「MyProdSubsciption」 訂用帳戶。
範例 3：取得預設訂用帳戶
C:\PS>(Get-AzureSubscription -Default).SubscriptionName此命令只會取得預設訂用帳戶的名稱。 命令會先取得訂用帳戶，然後使用 dot 方法來取得 訂用帳戶的 SubscriptionName 屬性。
範例 4：取得選取的訂用帳戶屬性
C:\PS>Get-AzureSubscription -Current | Format-List -Property SubscriptionName, Certificate此命令會傳回具有目前訂用帳戶名稱和憑證的清單。 它會使用 Get-AzureSubscription 命令來取得目前的訂用帳戶。 然後，它會使用管線將訂用帳戶傳送至 Format-List 命令，以在清單中顯示選取的屬性。
範例 5：使用替代訂用帳戶數據檔
C:\PS>Get-AzureSubscription -SubscriptionDataFile "C:\Temp\MySubscriptions.xml"此命令會從 C：\Temp\MySubscriptions.xml訂用帳戶數據檔取得訂用帳戶。 如果您在執行 Add-AzureAccount 或 Import-PublishSettingsFile Cmdlet 時指定替代訂用帳戶數據檔，請使用 SubscriptionDataFile 參數。
參數
-Current
只取得目前訂用帳戶，也就是指定為「目前」的訂用帳戶。根據預設， Get-AzureSubscription 會取得 Azure 帳戶中的所有訂用帳戶。 若要將訂用帳戶指定為「目前」，請使用 Select-AzureSubscription Cmdlet 的 Current 參數。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Default
只取得預設訂用帳戶，也就是指定為 「default」 的訂用帳戶。根據預設， Get-AzureSubscription 會取得 Azure 帳戶中的所有訂用帳戶。 若要將訂用帳戶指定為「預設」，請使用 Select-AzureSubscription Cmdlet 的 Default 參數。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ExtendedDetails
除了標準設定之外，還傳回訂用帳戶的配額資訊。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。
| 類型: | AzureSMProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SubscriptionId
| 類型: | String |
| 別名: | Id |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SubscriptionName
只取得指定的訂用帳戶。 輸入訂用帳戶名稱。 此值區分大小寫。 不支援萬用字元。 根據預設， Get-AzureSubscription 會取得 Azure 帳戶中的所有訂用帳戶。
| 類型: | String |
| 別名: | Name |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸入
None
您可以依名稱將輸入管線傳送至 SubscriptionName 屬性，但不能依值傳送。
輸出
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription
備註
- Get-AzureSubscription 會從 Add-AzureAccount 和 Import-PublishSettingsFile Cmdlet 所建立的訂用帳戶數據檔取得數據。