Compartir a través de

Get-AzureSubscription

  • Referencia
Módulo:
Azure

Obtiene las suscripciones de Azure en la cuenta de Azure.

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

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

El cmdlet Get-AzureSubscription obtiene las suscripciones de la cuenta de Azure. Puede usar este cmdlet para obtener información sobre la suscripción y canalizar la suscripción a otros cmdlets.

Get-AzureSubscription requiere acceso a las cuentas de Azure. Antes de ejecutar Get-AzureSubscription, debe ejecutar el cmdlet Add-AzureAccount o los cmdlets que descargan e instalan un archivo de configuración de publicación (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.

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: Obtener todas las suscripciones

C:\PS>Get-AzureSubscription

Este comando obtiene todas las suscripciones de la cuenta.

Ejemplo 2: Obtener una suscripción por nombre

C:\PS>Get-AzureSubscription -SubscriptionName "MyProdSubscription"

Este comando obtiene solo la suscripción "MyProdSubsciption".

Ejemplo 3: Obtener la suscripción predeterminada

C:\PS>(Get-AzureSubscription -Default).SubscriptionName

Este comando obtiene solo el nombre de la suscripción predeterminada. El comando obtiene primero la suscripción y, a continuación, usa el método dot para obtener la propiedad SubscriptionName de la suscripción.

Ejemplo 4: Obtención de las propiedades de suscripción seleccionadas

C:\PS>Get-AzureSubscription -Current | Format-List -Property SubscriptionName, Certificate

Este comando devuelve una lista con el nombre y el certificado de la suscripción actual. Usa un comando Get-AzureSubscription para obtener la suscripción actual. A continuación, canaliza la suscripción a un comando Format-List que muestra las propiedades seleccionadas en una lista.

Ejemplo 5: Uso de un archivo de datos de suscripción alternativo

C:\PS>Get-AzureSubscription -SubscriptionDataFile "C:\Temp\MySubscriptions.xml"

Este comando obtiene suscripciones del archivo de datos de suscripción C:\Temp\MySubscriptions.xml. Use el parámetro SubscriptionDataFile si especificó un archivo de datos de suscripción alternativo al ejecutar los cmdlets Add-AzureAccount o Import-PublishSettingsFile .

Parámetros

-Current

Obtiene solo la suscripción actual, es decir, la suscripción designada como "actual". De forma predeterminada, Get-AzureSubscription obtiene todas las suscripciones de las cuentas de Azure. Para designar una suscripción como "actual", use el parámetro Current del cmdlet Select-AzureSubscription .

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

-Default

Obtiene solo la suscripción predeterminada, es decir, la suscripción designada como "predeterminada". De forma predeterminada, Get-AzureSubscription obtiene todas las suscripciones de las cuentas de Azure. Para designar una suscripción como "predeterminada", use el parámetro Default del cmdlet Select-AzureSubscription .

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

-ExtendedDetails

Devuelve información de cuota para la suscripción, además de la configuración estándar.

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:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SubscriptionName

Obtiene solo la suscripción especificada. Escriba el nombre de la suscripción. El valor distingue mayúsculas de minúsculas. No se admite el uso de caracteres comodín. De forma predeterminada, Get-AzureSubscription obtiene todas las suscripciones de las cuentas de Azure.

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

Entradas

None

Puede canalizar la entrada a la propiedad SubscriptionName por nombre, pero no por valor.

Salidas

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Notas

  • Get-AzureSubscription obtiene datos del archivo de datos de suscripción que crean los cmdlets Add-AzureAccount e Import-PublishSettingsFile .