通过

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

Select-AzureSubscription

模块:
Azure Module

更改当前订阅和默认 Azure 订阅。

注意

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

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

SelectSubscriptionByNameParameterSet （默认值） 

Select-AzureSubscription
    -SubscriptionName <String>
    [-Account <String>]
    [-Current]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectDefaultSubscriptionByNameParameterSet 

Select-AzureSubscription
    -SubscriptionName <String>
    [-Account <String>]
    [-Default]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectSubscriptionByIdParameterSet 

Select-AzureSubscription
    -SubscriptionId <String>
    [-Account <String>]
    [-Current]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

SelectDefaultSubscriptionByIdParameterSet 

Select-AzureSubscription
    -SubscriptionId <String>
    [-Account <String>]
    [-Default]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

NoCurrentSubscriptionParameterSet 

Select-AzureSubscription
    [-Account <String>]
    [-NoCurrent]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

NoDefaultSubscriptionParameterSet 

Select-AzureSubscription
    [-Account <String>]
    [-NoDefault]
    [-PassThru]
    [-Profile <AzureSMProfile>]
    [<CommonParameters>]

说明

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

示例

示例 1：设置当前订阅

C:\PS> Select-AzureSubscription -Current -SubscriptionName ContosoEngineering

此命令使“ContosoEngineering”成为当前订阅。

示例 2：设置默认订阅

C:\PS> Select-AzureSubscription -Default -SubscriptionName ContosoFinance -SubscriptionDataFile "C:\subs\MySubscriptions.xml"

此命令将默认订阅更改为“ContosoFinance”。它将设置保存在Subscriptions.xml订阅数据文件中，而不是默认订阅数据文件。

参数

-Account

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Current

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

SelectSubscriptionByNameParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
SelectSubscriptionByIdParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Default

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

SelectDefaultSubscriptionByNameParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
SelectDefaultSubscriptionByIdParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NoCurrent

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

NoCurrentSubscriptionParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NoDefault

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

NoDefaultSubscriptionParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PassThru

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Profile

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

参数属性

类型:AzureSMProfile
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SubscriptionId

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:Id

参数集

SelectSubscriptionByIdParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
SelectDefaultSubscriptionByIdParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-SubscriptionName

Select-AzureSubscription cmdlet 设置并清除当前和默认 Azure 订阅。

“当前订阅”是当前 Windows PowerShell 会话中默认使用的订阅。 默认在所有 Windows PowerShell 会话中使用“默认订阅”。 使用“当前订阅”标签可以指定默认用于当前会话的不同订阅，而无需更改所有其他会话的“默认订阅”。

“默认”订阅指定保存在订阅数据文件中。 不保存特定于会话的“当前”指定。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本，请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:名称

参数集

SelectSubscriptionByNameParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
SelectDefaultSubscriptionByNameParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

None

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

输出

None or System.Boolean

如果使用 PassThru 参数，则此 cmdlet 返回布尔值。 默认情况下，它不会生成任何输出。