Set-AzureSubscription
變更 Azure 訂用帳戶。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。
Syntax
Set-AzureSubscription
-SubscriptionId <String>
[-Certificate <X509Certificate2>]
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Set-AzureSubscription
-SubscriptionName <String>
[-Certificate <X509Certificate2>]
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Set-AzureSubscription
-SubscriptionName <String>
-SubscriptionId <String>
-Certificate <X509Certificate2>
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Set-AzureSubscription Cmdlet 會建立及變更 Azure 訂用帳戶物件的屬性。 您可以使用此 Cmdlet 在不是預設訂用帳戶或變更目前儲存體帳戶的 Azure 訂用帳戶中運作。 如需目前和預設訂用帳戶的相關資訊，請參閱 Select-AzureSubscription Cmdlet。
此 Cmdlet 會在 Azure 訂用帳戶物件上運作，而不是實際的 Azure 訂用帳戶。 若要建立及布建 Azure 訂用帳戶，請流覽 Azure 入口網站 （ https://azure.microsoft.com/ ）。
此 Cmdlet 會變更您在使用 Add-AzureAccount 或 Import-AzurePublishSettingsFile Cmdlet 將 Azure 帳戶新增至 Windows PowerShell 時所建立的訂用帳戶資料檔案中的資料。
本主題描述 Microsoft Azure PowerShell 模組 0.8.10 版中的 Cmdlet。
若要取得您所使用的模組版本，請在 Azure PowerShell 主控台中輸入 (Get-Module -Name Azure).Version 。
範例
範例 1：變更現有的訂用帳戶1
C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert此範例會變更名為 ContosoEngineering 之訂用帳戶的憑證。
範例 2：變更服務端點
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"此命令會新增或變更 ContosoEngineering 訂用帳戶的自訂服務端點。
範例 3：清除屬性值
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null此命令會將 Certificate 和 ResourceManagerEndpoint 屬性的值設定為 null （$Null）。 這會清除這些屬性的值，而不會變更其他設定。
範例 4：使用替代訂用帳戶資料檔案
C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01此命令會將 ContosoFinance 訂用帳戶的目前儲存體帳戶變更為 ContosoStorage01。 此命令會使用 SubscriptionDataFile 參數來變更 C：\Azure\SubscriptionData.xml 訂用帳戶資料檔案中的資料。 根據預設， Set-AzureSubscription 會使用漫遊使用者設定檔中的預設訂用帳戶資料檔案。
參數
-Certificate
| Type: | X509Certificate2 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Context
| Type: | AzureStorageContext |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CurrentStorageAccountName
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Environment
指定 Azure 環境。
Azure 環境是 Microsoft Azure 的獨立部署，例如適用于全球 Azure 的 Azure 雲端，以及由中國 21Vianet 營運的 AzureChinaCloud。 您也可以使用 Azure Pack 和 WAPack Cmdlet 來建立內部部署 Azure 環境。 如需詳細資訊，請參閱 Azure Pack 。
| Type: | String |
| 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 |
-ResourceManagerEndpoint
指定 Azure Resource Manager 資料的端點，包括與帳戶相關聯的資源群組相關資料。 如需 Azure Resource Manager 的詳細資訊，請參閱 Azure Resource Manager Cmdlet （ https://go.microsoft.com/fwlink/?LinkID=394765 ） 和使用 Windows PowerShell 搭配 Resource Manager （ https://go.microsoft.com/fwlink/?LinkID=394767 ）。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceEndpoint
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubscriptionId
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubscriptionName
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸入
None
您可以透過屬性名稱將輸入管線傳送至此 Cmdlet，但不能依值傳送。
輸出
None or System.Boolean
當您使用 PassThru 參數時，這個 Cmdlet 會傳回布林值。 根據預設，此 Cmdlet 不會傳回任何輸出。