Remove-Mailbox

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-06-28

Utilice el cmdlet Remove-Mailbox para quitar la cuenta de usuario asociada con un buzón particular en el servicio de directorio de Active Directory y para procesar el buzón asociado y desconectado tal como especifican los parámetros especificados.

Sintaxis

Remove-Mailbox -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Permanent <$true | $false>] [-WhatIf [<SwitchParameter>]]

Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

El cmdlet Remove-Mailbox elimina de Active Directory la cuenta de usuario asociada con un buzón determinado y, a continuación, procesa el buzón asociado y desconectado tal como indican los parámetros especificados.

Utilice el parámetro Identity sólo para desconectar el buzón del usuario y quitar el objeto de usuario de Active Directory. El objeto de buzón aún existe. De forma predeterminada, este buzón permanecerá en la base de datos de Exchange durante 30 días y, a continuación, será eliminado.

Utilice los parámetros Identity y Permanent para desconectar el buzón del usuario, quite el objeto de usuario de Active Directory y quite el objeto de buzón de la base de datos de Exchange. El objeto de buzón no permanecerá en la base de datos de Exchange como buzón desconectado.

Utilice los parámetros Database y StoreMailboxIdentity para quitar un objeto de buzón de la base de datos de Exchange. En este caso, el objeto de buzón ya ha sido desconectado del usuario. Por ejemplo, si ejecuta el cmdlet Disable-Mailbox, el objeto de buzón de Exchange aún existe, pero se desconecta del objeto de usuario de Active Directory. Puede usar los parámetros Database y StoreMailboxIdentity para quitar este objeto de buzón desconectado.

Para ejecutar el cmdlet Remove-Mailbox, deberá delegar a la cuenta que utilice las funciones siguientes:

  • Función Administrador de destinatarios de Exchange

  • Función de operador de cuentas para los contenedores de Active Directory aplicables

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Database

Necesario

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

El parámetro Database especifica la base de datos que contiene el objeto de buzón. Puede utilizar uno de los siguientes valores:

  • GUID

  • Nombre de la base de datos

  • Nombre del servidor\nombre de la base de datos

  • Nombre del servidor\grupo de almacenamiento\nombre de la base de datos

Si no especifica el nombre del servidor, el cmdlet buscará la base de datos en el servidor local. Si tiene varias bases de datos con el mismo nombre en el mismo servidor, debe especificar el grupo de almacenamiento.

Este parámetro se tiene que utilizar junto con el parámetro StoreMailboxIdentity. El parámetro Database no puede utilizarse con el parámetro Identity. Si ha desconectado un buzón del usuario asociado y desea quitar el objeto de buzón del almacén de Exchange, utilice los parámetros Database y StoreMailboxIdentity.

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

El parámetro Identity identifica el objeto de buzón que desea eliminar. Puede utilizar uno de los siguientes valores:

  • ADObjectID

  • Nombre completo (DN)

  • DN heredado, GUID

  • Dominio\Nombre de cuenta

  • Nombre principal de usuario (UPN)

  • Dirección de correo electrónico

  • Alias

El parámetro Identity no puede utilizarse con el parámetro Database.

StoreMailboxIdentity

Necesario

Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter

El parámetro StoreMailboxIdentity identifica el objeto de buzón que se eliminará. El parámetro StoreMailboxIdentity se utiliza en conjunto con el parámetro Database para quitar el objeto de buzón de la base de datos de Exchange. Si ha desconectado un buzón del usuario asociado y desea quitar el objeto de buzón del almacén de Exchange, utilice los parámetros Database y StoreMailboxIdentity.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

El parámetro DomainController especifica el controlador del dominio que escribe el cambio de configuración en Active Directory. Utilice el nombre de dominio completo (FQDN) del controlador de dominio que desee utilizar.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

El parámetro IgnoreDefaultScope indica al comando que omita la opción predeterminada del ámbito de destinatario para el Shell de administración de Exchange y que utilice todo el bosque como ámbito. Esto permite que el comando tenga acceso a objetos de Active Directory que no están actualmente en el ámbito predeterminado. El uso del parámetro IgnoreDefaultScope introduce las siguientes restricciones:

  • No puede utilizar el parámetro DomainController. El comando utilizará un servidor de catálogo global adecuado automáticamente.

  • Sólo puede utilizar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.

Permanent

Opcional

System.Boolean

El parámetro Permanent, cuando se utiliza junto con el parámetro Identity, desconecta el buzón del usuario, quita el objeto de usuario asociado de Active Directory y quita el objeto de buzón de la base de datos de Exchange. Los dos valores posibles para este parámetro son $true o $false. El valor predeterminado es $false.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Excepciones

Excepciones Descripción

 

Ejemplo

El primer ejemplo muestra cómo desconectar el buzón de usuario de John Peoples (john) de la cuenta del usuario y quitar el objeto de buzón de Active Directory. El buzón seguirá en la base de datos de Exchange durante el período de conservación del buzón eliminado que se haya configurado para la base de datos.

El segundo ejemplo muestra cómo desconectar el buzón de usuario de John Peoples (john) de la cuenta del usuario, quitar el objeto de buzón de Active Directory y quitar el buzón de la base de datos de Exchange.

El tercer ejemplo muestra cómo eliminar el buzón de John People (john) de la base de datos de Exchange, suponiendo que el buzón ya se haya desconectado del usuario. El ejemplo muestra cómo utilizar el cmdlet Get-MailboxStatistics para obtener el valor GUID del buzón, mediante el nombre que se muestra del buzón desconectado. Este valor es necesario para el parámetro StoreMailboxIdentity del cmdlet Remove-Mailbox.

Remove-Mailbox -Identity contoso\john
Remove-Mailbox -Identity contoso\john -Permanent $true
$Temp = Get-MailboxStatistics | Where {$_.DisplayName -eq 'John Peoples'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid