Remove-AzureAccount
Elimina una cuenta de Azure de Windows PowerShell.
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.
Syntax
Remove-AzureAccount
-Name <String>
[-Force]
[-PassThru]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet Remove-AzureAccount elimina una cuenta de Azure y sus suscripciones del archivo de datos de suscripción en el perfil de usuario móvil. No elimina la cuenta de Microsoft Azure ni cambia la cuenta real de ninguna manera.
El uso de este cmdlet es muy parecido a cerrar sesión en su cuenta de Azure. Y, si desea volver a iniciar sesión en la cuenta, use Add-AzureAccount o Import-AzurePublishSettingsFile para agregar la cuenta a Windows PowerShell de nuevo.
También puede usar el cmdlet Remove-AzureAccount para cambiar la forma en que los cmdlets de Azure PowerShell inician sesión en su cuenta de Azure. Si la cuenta tiene un certificado de administración de Import-AzurePublishSettingsFile y un token de acceso de Add-AzureAccount, los cmdlets de Azure PowerShell solo usan el token de acceso; omiten el certificado de administración. Para usar el certificado de administración, ejecute Remove-AzureAccount. Cuando Remove-AzureAccount encuentra un certificado de administración y un token de acceso, solo elimina el token de acceso, en lugar de eliminar la cuenta. El certificado de administración sigue estando ahí, por lo que la cuenta sigue estando disponible para 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: Quitar una cuenta
PS C:\> Remove-AzureAccount -Name admin@contoso.comEste comando quita del admin@contoso.com archivo de datos de suscripción. Cuando se completa el comando, la cuenta ya no está disponible para Windows PowerShell.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predeterminado: | False |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Suprime el mensaje de confirmación. De forma predeterminada, Remove-AzureAccount le pide antes de quitar la cuenta de Windows PowerShell.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica el nombre de la cuenta que se va a quitar. El valor del parámetro distingue mayúsculas de minúsculas. No se admite el uso de caracteres comodín.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predeterminado: | False |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.