Compartir a través de

Select-AzureSubscription

  • Referencia
Módulo:
Azure

Cambia las suscripciones de Azure actuales y predeterminadas.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      [-Account <String>]
      [-NoCurrent]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      [-Account <String>]
      [-NoDefault]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

El cmdlet Select-AzureSubscription establece y borra las suscripciones de Azure actuales y predeterminadas.

La "suscripción actual" es la suscripción que se usa de forma predeterminada en la sesión actual de Windows PowerShell. La "suscripción predeterminada" se usa de forma predeterminada en todas las sesiones de Windows PowerShell. La etiqueta "suscripción actual" permite especificar una suscripción diferente que se usará de forma predeterminada para la sesión actual sin cambiar la "suscripción predeterminada" para todas las demás sesiones.

La designación de suscripción "predeterminada" se guarda en el archivo de datos de suscripción. No se guarda la designación "actual" específica de la sesión.

En este tema se describe el cmdlet en la versión 0.8.10 del módulo de Microsoft Azure PowerShell. Para obtener la versión del módulo que usa, en la consola de Azure PowerShell, escriba (Get-Module -Name Azure).Version.

Ejemplos

Ejemplo 1: Establecimiento de la suscripción actual

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

Este comando hace que "ContosoEngineering" sea la suscripción actual.

Ejemplo 2: Establecimiento de la suscripción predeterminada

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

Este comando cambia la suscripción predeterminada a "ContosoFinance". Guarda la configuración en el archivo de datos de Subscriptions.xml suscripción, en lugar del archivo de datos de suscripción predeterminado.

Parámetros

-Account

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Current

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Default

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoCurrent

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoDefault

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve $True si el comando se ejecuta correctamente y $False si se produce un error. De forma predeterminada, este cmdlet no devuelve ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SubscriptionId

Tipo:String
Alias:Id
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SubscriptionName

Tipo:String
Alias:Name
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

None

Puede canalizar la entrada a este cmdlet por nombre de propiedad, pero no por valor.

Salidas

None or System.Boolean

Si usa el parámetro PassThru , este cmdlet devuelve un valor booleano. De forma predeterminada, no genera ninguna salida.