Compartir a través de

Set-AzureSubscription

  • Referencia
Módulo:
Azure

Cambia una suscripción de Azure.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (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 de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet Set-AzureSubscription establece y cambia las propiedades de un objeto de suscripción de Azure. Puede usar este cmdlet para trabajar en una suscripción de Azure que no sea la suscripción predeterminada o para cambiar la cuenta de almacenamiento actual. Para obtener información sobre las suscripciones actuales y predeterminadas, consulte el cmdlet Select-AzureSubscription .

Este cmdlet funciona en un objeto de suscripción de Azure, no en la suscripción real de Azure. Para crear y aprovisionar una suscripción de Azure, visite Azure Portal (https://azure.microsoft.com/).

Este cmdlet cambia los datos del archivo de datos de suscripción que se crean al usar el cmdlet Add-AzureAccount o Import-AzurePublishSettingsFile para agregar una cuenta de Azure a Windows PowerShell.

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: Cambiar una suscripción existente1

C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert

En este ejemplo se cambia el certificado de la suscripción denominada ContosoEngineering.

Ejemplo 2: Cambiar el punto de conexión de servicio

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"

Este comando agrega o cambia un punto de conexión de servicio personalizado para la suscripción de ContosoEngineering.

Ejemplo 3: Borrar valores de propiedad

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null

Este comando establece los valores de las propiedades Certificate y ResourceManagerEndpoint en null ($Null). Esto borra los valores de esas propiedades sin cambiar otras configuraciones.

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

C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01

Este comando cambia la cuenta de almacenamiento actual de la suscripción ContosoFinance a ContosoStorage01. El comando usa el parámetro SubscriptionDataFile para cambiar los datos en el archivo de datos de suscripción C:\Azure\SubscriptionData.xml. De forma predeterminada, Set-AzureSubscription usa el archivo de datos de suscripción predeterminado en el perfil de usuario móvil.

Parámetros

-Certificate

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

-Context

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

-CurrentStorageAccountName

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

-Environment

Especifica un entorno de Azure.

Un entorno de Azure que es una implementación independiente de Microsoft Azure, como AzureCloud para Azure global y AzureChinaCloud para Azure operado por 21Vianet en China. También puede crear entornos de Azure locales mediante Azure Pack y los cmdlets WAPack. Para más información, consulte Azure Pack.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
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

-ResourceManagerEndpoint

Especifica el punto de conexión para los datos de Azure Resource Manager, incluidos los datos sobre los grupos de recursos asociados a la cuenta. Para más información sobre Azure Resource Manager, consulte Cmdlets de Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) y Uso de Windows PowerShell con Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

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

-ServiceEndpoint

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

-SubscriptionId

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

-SubscriptionName

Tipo:String
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

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