你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzureSubscription

参考

模块:: Azure

更改 Azure 订阅。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器（ARM）资源。

语法

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>]

说明

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

类型:	X509Certificate2
Position:	Named
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Context

类型:	AzureStorageContext
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-CurrentStorageAccountName

类型:	String
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Environment

指定 Azure 环境。

Azure 环境独立于 azure 部署Microsoft，例如 AzureCloud for global Azure，以及由世纪互联在中国运营的 AzureChinaCloud for Azure。还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。有关详细信息，请参阅 Azure Pack。

类型:	String
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

如果命令成功，$False失败，则返回$True。默认情况下，此 cmdlet 不返回任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

类型:	AzureSMProfile
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceManagerEndpoint

指定 Azure 资源管理器数据的终结点，包括与帐户关联的资源组的相关数据。有关 Azure 资源管理器的详细信息，请参阅 Azure 资源管理器 Cmdlet （https://go.microsoft.com/fwlink/?LinkID=394765）和将 Windows PowerShell 与资源管理器配合使用（https://go.microsoft.com/fwlink/?LinkID=394767）。

类型:	String
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceEndpoint

类型:	String
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SubscriptionId

类型:	String
Position:	Named
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SubscriptionName

类型:	String
Position:	Named
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

输入

None

可以通过属性名称（而不是值）通过管道将输入传递给此 cmdlet。

输出

None or System.Boolean

使用 PassThru 参数时，此 cmdlet 返回布尔值。默认情况下，此 cmdlet 不返回任何输出。

通过