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