Remove-Mailbox (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
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> [-DomainController <Fqdn>] [-Permanent <$true | $false>]
Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-DomainController <Fqdn>]
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 Active Directory correspondientes
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 usar uno de los siguientes valores:
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 usar uno de los siguientes valores:
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. |
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 usar. |
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 de este parámetro son $true o $false. El valor predeterminado es $false. |
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