Compartir a través de

Remove-AzureSubscription

  • Referencia
Módulo:
Azure

Elimina una suscripción de Azure de Windows PowerShell.

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

Remove-AzureSubscription
      -SubscriptionName <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureSubscription
      -SubscriptionId <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-AzureSubscription elimina una suscripción de Azure del archivo de datos de suscripción para que Windows PowerShell no pueda encontrarlo. Este cmdlet no elimina la suscripción de Microsoft Azure ni cambia la suscripción real de ninguna manera.

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: Eliminación de una suscripción

C:\PS> Remove-AzureSubscription -SubscriptionName Test

Confirm
Are you sure you want to perform this action?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Este comando elimina la suscripción "Prueba" del archivo de datos de suscripción predeterminado.

Ejemplo 2: Eliminación de un archivo de datos de suscripción alternativo

C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force

Este comando elimina la suscripción de prueba del archivo de datos de suscripción de MySubscriptions.xml. El comando usa el parámetro Force para suprimir el mensaje de confirmación.

Ejemplo 3: Eliminación de una suscripción en un script

C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}

Este comando usa el comando Remove-AzureSubscription en una instrucción If . Usa el parámetro PassThru , que devuelve un valor booleano, para determinar si se ejecuta el bloque de script en la instrucción If .

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Force

Suprime el mensaje de confirmación.

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

-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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
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 lo contrario, no devuelve ningún resultado.