Set-MailboxDatabase

 

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

Última modificación del tema: 2007-09-19

Use el cmdlet Set-MailboxDatabase para definir los atributos de una base de datos de buzones.

Sintaxis

Set-MailboxDatabase -Identity <DatabaseIdParameter> [-AllowFileRestore <$true | $false>] [-Confirm [<SwitchParameter>]] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IndexEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-JournalRecipient <RecipientIdParameter>] [-MailboxRetention <EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true | $false>] [-Name <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-PublicFolderDatabase <DatabaseIdParameter>] [-QuotaNotificationSchedule <Schedule>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-MailboxDatabase [-AllowFileRestore <$true | $false>] [-Confirm [<SwitchParameter>]] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IndexEnabled <$true | $false>] [-Instance <MailboxDatabase>] [-IssueWarningQuota <Unlimited>] [-JournalRecipient <RecipientIdParameter>] [-MailboxRetention <EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true | $false>] [-Name <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-PublicFolderDatabase <DatabaseIdParameter>] [-QuotaNotificationSchedule <Schedule>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Para ejecutar el cmdlet Set-MailboxDatabase, la cuenta que use debe tener delegadas las siguientes funciones:

  • Función Administrador de Exchange Server y grupo Administradores local para el servidor de destino

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

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

El parámetro Identity identifica la base de datos de buzones para la que quiere definir uno o más atributos. Puede usar los siguientes valores:

  • GUID

  • Nombre distintivo (DN)

  • Nombre de la base de datos de buzones

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

  • Nombre del servidor\nombre de la base de datos

  • Nombre del 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, debe especificar el grupo de almacenamiento.

AllowFileRestore

Opcional

System.Boolean

El parámetro AllowFileRestore especifica si se permite restaurar una base de datos desde una copia de seguridad. Los dos valores posible son $true o $false. Si especifica $true, el comando permitirá montar una base de datos que no coincida con la entrada de base de datos del servicio de directorio Active Directory. Si especifica $false, el comando no permitirá montar una base de datos que no coincida con la entrada de base de datos del servicio de directorio Active Directory, por lo que no podrá sustituir una base de datos existente por una que se acabe de crear.

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.

DeletedItemRetention

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

El parámetro DeletedItemRetention especifica el período de tiempo que se van a mantener los elementos eliminados. Para especificar un valor, especifíquelo como un intervalo de tiempo: dd.hh:mm:ss donde d = días, h = horas, m = minutos y s = segundos. Por ejemplo, para especificar un intervalo de 15 horas, especifique 15:00:00. El período máximo de tiempo que se pueden mantener los elementos eliminados es de 24.855 días. De forma predeterminada, los elementos eliminados se retienen durante 14 días. Este atributo se aplica a todos los buzones de la base de datos de buzones que no tengan definido su propio atributo de retención de elementos.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración Active Directory, incluya el parámetro DomainController del comando.

EventHistoryRetentionPeriod

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

El parámetro EventHistoryRetentionPeriod especifica el período de tiempo que se van a mantener los datos de eventos. Estos datos de eventos se almacenan en la tabla del historial de eventos, en el almacén de Exchange. Incluye información sobre los cambios en diversos objetos de la base de datos de buzones. Puede usar este parámetro para evitar que la tabla del historial de eventos sea demasiado grande y ocupe demasiado espacio en disco. Para especificar un valor, especifíquelo como un intervalo de tiempo: dd.hh:mm:ss donde d = días, h = horas, m = minutos y s = segundos. Por ejemplo, para especificar un intervalo de 15 horas, especifique 15:00:00.

IndexEnabled

Opcional

System.Boolean

El parámetro IndexEnabled especifica si se debe habilitar la búsqueda de Exchange para esta base de datos de buzones. Los dos valores posibles de este parámetro son $true o $false.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.MailboxDatabase

El parámetro Instance normalmente se usa en scripts en las que un administrador o desarrollador debe suministrar valores a un comando. El parámetro Instance es equivalente a canalizar el resultado de un comando a otro, pero permite al script asignar valores por medio de variables en lugar de intentar construir un canal. Los administradores que escriben comandos en el símbolo del sistema normalmente no usan el parámetro Instance. Está incluido en la tabla de parámetros como referencia del desarrollador.

IssueWarningQuota

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro IssueWarningQuota especifica el tamaño de buzón que se debe alcanzar para enviar un mensaje de advertencia al usuario.

Este atributo se aplica a todos los buzones de la base de datos de buzones que no tengan definido su propio atributo de cuota de advertencia. Debe especificar un número o "ilimitado". El valor predeterminado es 1,9 gigabytes (GB).

JournalRecipient

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

El parámetro JournalRecipient especifica el buzón al que se envían los informes de diario.

MailboxRetention

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

El parámetro MailboxRetention especifica el período de tiempo que se van a mantener los buzones eliminados. Para especificar un valor, especifíquelo como un intervalo de tiempo: dd.hh:mm:ss donde d = días, h = horas, m = minutos y s = segundos. Por ejemplo, para especificar un intervalo de 15 horas, especifique 15:00:00. El período máximo de tiempo que se pueden mantener los buzones es de 24.855 días. De forma predeterminada, los buzones eliminados se mantienen durante 30 días. Este atributo se aplica a todos los buzones de la base de datos de buzones.

MaintenanceSchedule

Opcional

Microsoft.Exchange.Data.Schedule

El parámetro MaintenanceSchedule especifica cuándo se realizará el mantenimiento en la base de datos de buzones. El mantenimiento incluye la desfragmentación en línea, la eliminación de elementos que han superado su período de retención, la eliminación de índices no usados y otras tareas de depuración.

El formato es Día de inicio.Hora.Minuto [a.m./p.m.M]-Día de finalización.Hora:Minuto [a.m./p.m.]. Los valores que se pueden usar para los día de inicio y finalización son:

  • Nombre completo del día

  • Nombre abreviado del día

  • Número entero de 0 a 6, donde 0 = Domingo

Si prefiere usar un reloj de 24 horas, omita a.m./p.m. Si usa el formato a.m./p.m., debe dejar un espacio entre la hora y a.m. o p.m.

Los formatos se pueden mezclar.

Entre la hora de inicio y la de finalización debe haber al menos un intervalo de 15 minutos. Los minutos se redondearán a 0, 15, 30 o 45. Si especifica más de un intervalo, debe haber un mínimo de 15 minutos entre cada intervalo.

Ejemplos:

  • "Dom.11:30 p.m. - Lun.1:30 a.m."

  • 6.22:00-6.22:15 (el mantenimiento se ejecutará desde el sábado a las 10:00 p.m. hasta las 10:15 p.m. del mismo día).

  • "Lunes.4:30 a.m. - Lunes.5:30 a.m.","Miércoles.4:30 a.m. - Miércoles.5:30 a.m." (el mantenimiento se ejecutará las madrugadas de los lunes y los miércoles de 4:30 a 5:30).

  • "Dom.1:15 a.m.-Lunes.23:00"

MountAtStartup

Opcional

System.Boolean

El parámetro MountAtStartup especifica si se debe montar esta base de datos de buzones cuando se inicia el servicio Almacén de información de Microsoft Exchange. Los dos valores posibles de este parámetro son $true o $false.

Name

Opcional

System.String

El parámetro Name especifica el nombre de la base de datos de buzones.

OfflineAddressBook

Opcional

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

El parámetro OfflineAddressBook especifica la libreta de direcciones asociada a esta base de datos de buzones.

ProhibitSendQuota

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro ProhibitSendQuota especifica el tamaño del buzón al que los usuarios asociados a los buzones de esta base de datos de buzones ya no podrán seguir enviando mensajes. Este atributo se aplica a todos los buzones de la base de datos de buzones que no tengan definido su propio atributo de cuota de prohibido enviar.

Debe especificar un número o "ilimitado".

ProhibitSendReceiveQuota

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro ProhibitSendReceiveQuota especifica el tamaño del buzón al que el usuario asociado a este buzón no podrá seguir enviando o recibiendo mensajes. Este atributo se aplica a todos los buzones de la base de datos de buzones que no tengan definido su propio atributo de cuota de prohibido enviar y recibir.

Debe especificar un número o "ilimitado".

PublicFolderDatabase

Opcional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

El parámetro PublicFolderDatabase especifica la base de datos de carpetas públicas asociada a esta base de datos de buzones. Puede usar los siguientes valores:

  • GUID

  • Nombre distintivo (DN)

  • Nombre de la base de datos de carpetas públicas

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

  • Nombre del servidor\nombre de la base de datos

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

QuotaNotificationSchedule

Opcional

Microsoft.Exchange.Data.Schedule

El parámetro QuotaNotificationSchedule especifica cuándo se envían los mensajes de cuota a los buzones que han alcanzado uno de los valores de cuota.

El formato es Día de inicio.Hora.Minuto [a.m./p.m.]-Día de finalización.Hora:Minuto [a.m./p.m.]. Los valores que se pueden usar para los día de inicio y finalización son:

  • Nombre completo del día

  • Nombre abreviado del día

  • Número entero de 0 a 6, donde 0 = Domingo

Si prefiere usar un reloj de 24 horas, omita a.m./p.m.

Los formatos se pueden mezclar.

Entre la hora de inicio y la de finalización debe haber al menos un intervalo de 15 minutos. Los minutos se redondearán a 0, 15, 30 o 45. Si especifica más de un intervalo, debe haber un mínimo de 15 minutos entre cada intervalo.

Ejemplos:

  • "Dom.11:30 p.m. - Lun.1:30 a.m."

  • 6.22:00-6.22:15 (la expiración se ejecutará desde el sábado a las 10:00 p.m. hasta las 10:15 p.m. del mismo día).

  • "Lunes.4:30 a.m. - Lunes.5:30 a.m.","Miércoles.4:30 a.m. - Miércoles.5:30 a.m." (la notificación se ejecutará las madrugadas de los lunes y los miércoles de 4:30 a 5:30).

  • "Dom.1:15 a.m. - Lunes.23:00"

RetainDeletedItemsUntilBackup

Opcional

System.Boolean

El parámetro RetainDeletedItemsUntilBackup especifica si se van o no a conservar los elementos eliminados hasta la siguiente copia de seguridad. Los dos valores posibles de este parámetro son $true o $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 siguiente ejemplo muestra cómo definir el período de tiempo durante el que se van a guardar los elementos eliminados. Si un buzón en particular tiene definida su propia retención, se usará ese valor en lugar del valor definido en la base de datos de buzones.

Set-MailboxDatabase "Mailbox Database01" -DeletedItemRetention 7.00:00:00