Compartilhar via


Set-MailboxDatabase

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-09-19

Use o cmdlet Set-MailboxDatabase para definir os atributos de um banco de dados de caixa de correio.

Sintaxe

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>]]

Descrição detalhada

Para executar o cmdlet Set-MailboxDatabase, você deve usar uma conta à qual estejam delegadas as seguintes funções:

  • Função Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

O parâmetro Identity identifica o banco de dados de caixa de correio para o qual você deseja definir um ou mais atributos. É possível usar os seguintes valores:

  • GUID

  • DN (nome distinto)

  • Nome do banco de dados de caixa de correio

  • Nome do servidor\nome do grupo de armazenamento\nome do banco de dados

  • Nome do servidor\nome do banco de dados

  • Nome do grupo de armazenamento\nome do banco de dados

Se você não especificar o nome do servidor, o cmdlet procurará o banco de dados no servidor local. Se tiver vários bancos de dados com o mesmo nome, você deverá especificar o grupo de armazenamento.

AllowFileRestore

Opcional

System.Boolean

O parâmetro AllowFileRestore especifica se deve ser permitida a restauração de um banco de dados a partir de um backup. Os dois valores possíveis são $true ou $false. Se você especificar $true, o comando permitirá que um banco de dados que não corresponde à entrada do banco de dados no Active Directory seja montado. Se você especificar $false, o comando não permitirá que um banco de dados que não corresponde à entrada do banco de dados no Active Directory seja montado, por isso você não poderá substituir um banco de dados existente por um banco de dados recém-criado.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DeletedItemRetention

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

O parâmetro DeletedItemRetention especifica por quanto tempo manter itens excluídos. Para especificar um valor, digite-o como um período de tempo: dd.hh:mm:ss, em que d= dias, h= horas, m= minutos e s= segundos. Por exemplo, para especificar um intervalo de 15 horas, digite 15:00:00. O tempo máximo para reter itens excluídos é 24.855 dias. Por padrão, itens excluídos são retidos por 14 dias. O atributo se aplica a todas as caixas de correio desse banco de dados de caixa de correio que não possuam seu próprio conjunto de atributos de retenção de itens.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.

EventHistoryRetentionPeriod

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

O parâmetro EventHistoryRetentionPeriod especifica por quanto tempo manter dados do evento. Os dados deste evento são armazenados na tabela de histórico do evento no armazenamento do Exchange. Eles incluem informações sobre alterações em diversos objetos do banco de dados de caixa de correio. Você pode usar este parâmetro para impedir que a tabela de histórico de eventos fique grande demais e use muito espaço em disco. Para especificar um valor, digite-o como um período de tempo: dd.hh:mm:ss, em que d= dias, h= horas, m= minutos e s= segundos. Por exemplo, para especificar um intervalo de 15 horas, digite 15:00:00.

IndexEnabled

Opcional

System.Boolean

O parâmetro IndexEnabled especifica se a Pesquisa do Exchange deve ser habilitada para esse banco de dados de caixa de correio. Os dois valores possíveis para esse parâmetro são $true ou $false.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.MailboxDatabase

O parâmetro Instance é normalmente usado em scripts em que um administrador ou desenvolvedor precisa fornecer valores para um comando. O parâmetro Instance é equivalente a canalizar o resultado de um comando para outro, mas permite que o script atribua valores por meio de variáveis em vez de tentar construir um pipeline. O parâmetro Instance é raramente usado por administradores que digitam comandos em um prompt de comando. Ele é incluído na tabela de parâmetros para referência do desenvolvedor.

IssueWarningQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro IssueWarningQuota especifica o tamanho da caixa de correio na qual uma mensagem de aviso é enviada ao usuário.

O atributo se aplica a todas as caixas de correio desse banco de dados de caixa de correio que não possuam seu próprio conjunto de atributos de cota de avisos. Você deve especificar um inteiro ou "ilimitado." O valor padrão é 1,9 GB (gigabytes).

JournalRecipient

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro JournalRecipient especifica a caixa de correio para a qual os relatórios de diário são enviados.

MailboxRetention

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

O parâmetro MailboxRetention especifica por quanto tempo manter caixas de correio excluídas. Para especificar um valor, digite-o como um período de tempo: dd.hh:mm:ss, em que d= dias, h= horas, m= minutos e s= segundos. Por exemplo, para especificar um intervalo de 15 horas, digite 15:00:00. O tempo máximo para reter caixas de correio é 24.855 dias. Por padrão, caixas de correio excluídas são retidas por 30 dias. O atributo se aplica a todas as caixas de correio desse banco de dados de caixa de correio.

MaintenanceSchedule

Opcional

Microsoft.Exchange.Data.Schedule

O parâmetro MaintenanceSchedule especifica quando a manutenção será feita no banco de dados de caixa de correio. A manutenção inclui desfragmentação online, remoção de itens que passaram do período de retenção, remoção de índices não utilizados e outras tarefas de limpeza.

O formato é StartDay.Hour:Minute [AM/PM]-EndDay.Hour:Minute [AM/PM]. Você pode usar os seguintes valores para os dias inicial e final:

  • Nome completo do dia

  • Nome abreviado do dia

  • Inteiro de 0 a 6, em que 0 = Domingo

Se preferir usar o horário no formato 24 horas, omita AM/PM. Se você utiliza AM/PM, deve incluir um espaço entre a hora e o AM ou PM.

Os formatos podem ser mistos.

A hora de início e a hora de término devem ser de pelo menos 15 minutos. Os minutos serão arredondados para baixo para 0, 15, 30 ou 45. Se você especificar mais de um intervalo, deverá ser de pelo menos 15 minutos entre cada intervalo.

Exemplos:

  • "Dom.11:30 PM-Seg.1:30 AM"

  • 6.22:00-6.22:15 (A manutenção ocorrerá no sábado das 10:00 PM às 10:15 PM.)

  • "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM" (A manutenção ocorrerá nas manhãs de segunda e de quarta-feira das 4:30 às 5:30.)

  • "Dom.1:15 AM-Segunda.23:00"

MountAtStartup

Opcional

System.Boolean

O parâmetro MountAtStartup especifica se esse banco de dados de caixa de correio deverá ser montado quando o serviço Armazenamento de Informações do Microsoft Exchange for iniciado. Os dois valores possíveis para esse parâmetro são $true ou $false.

Name

Opcional

System.String

O parâmetro Name especifica o nome do banco de dados de caixa de correio.

OfflineAddressBook

Opcional

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

O parâmetro OfflineAddressBook especifica o catálogo de endereços associado a esse banco de dados de caixa de correio.

ProhibitSendQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ProhibitSendQuota especifica o tamanho da caixa de correio na qual usuários associados a caixas de correio desse banco de dados de caixa de correio não poderão mais enviar mensagens. O atributo se aplica a todas as caixas de correio desse banco de dados de caixa de correio que não possuam seu próprio conjunto de atributos de cota de proibição de envio.

Você deve especificar um inteiro ou "ilimitado."

ProhibitSendReceiveQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ProhibitSendReceiveQuota especifica o tamanho da caixa de correio na qual o respectivo usuário associado não poderá mais enviar ou receber mensagens. O atributo se aplica a todas as caixas de correio desse banco de dados de caixa de correio que não possuam seu próprio conjunto de atributos de cota de proibição de envio e recebimento.

Você deve especificar um inteiro ou "ilimitado."

PublicFolderDatabase

Opcional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

O parâmetro PublicFolderDatabase especifica o banco de dados de pasta pública associado a esse banco de dados de caixa de correio. É possível usar os seguintes valores:

  • GUID

  • DN (nome distinto)

  • Nome do banco de dados de pasta pública

  • Nome do servidor\nome do grupo de armazenamento\nome do banco de dados

  • Nome do servidor\nome do banco de dados

  • Nome do grupo de armazenamento\nome do banco de dados

QuotaNotificationSchedule

Opcional

Microsoft.Exchange.Data.Schedule

O parâmetro QuotaNotificationSchedule especifica quando mensagens de cota são enviadas para caixas de correio que tenham atingido um dos valores de cota.

O formato é StartDay.Hour:Minute [AM/PM]-EndDay.Hour:Minute [AM/PM]. Você pode usar os seguintes valores para os dias inicial e final:

  • Nome completo do dia

  • Nome abreviado do dia

  • Inteiro de 0 a 6, em que 0 = Domingo

Se preferir usar o horário no formato 24 horas, omita AM/PM.

Os formatos podem ser mistos.

A hora de início e a hora de término devem ser de pelo menos 15 minutos. Os minutos serão arredondados para baixo para 0, 15, 30 ou 45. Se você especificar mais de um intervalo, deverá ser de pelo menos 15 minutos entre cada intervalo.

Exemplos:

  • "Dom.11:30 PM-Seg.1:30 AM"

  • 6.22:00-6.22:15 (A notificação ocorrerá no sábado das 10:00 PM às 10:15 PM.)

  • "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM" (A notificação ocorrerá nas manhãs de segunda e de quarta-feira das 4:30 às 5:30.)

  • "Dom.1:15 AM-Segunda.23:00"

RetainDeletedItemsUntilBackup

Opcional

System.Boolean

O parâmetro RetainDeletedItemsUntilBackup especifica se deve manter itens excluídos até o próximo backup. Os dois valores possíveis para esse parâmetro são $true ou $false.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

O exemplo a seguir mostra como definir o tempo pelo qual itens excluídos devem ser retidos. Se uma determinada caixa de correio tiver seu próprio conjunto de retenção de itens, esse valor será usado em vez do valor definido no banco de dados de caixa de correio.

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