Set-MailboxServer
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2008-01-21
Use o cmdlet Set-MailboxServer para modificar atributos em um servidor de Caixa de Correio do Exchange, especificando a identidade desse servidor e os atributos a serem modificados.
Sintaxe
Set-MailboxServer -Identity <MailboxServerIdParameter> [-AutoDatabaseMountDial <Lossless | GoodAvailability | BestAvailability>] [-ClusteredStorageType <Disabled | NonShared | Shared>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderLogForManagedFoldersEnabled <$true | $false>] [-ForcedDatabaseMountAfter <Unlimited>] [-JournalingLogForManagedFoldersEnabled <$true | $false>] [-Locale <MultiValuedProperty>] [-LogDirectorySizeLimitForManagedFolders <Unlimited>] [-LogFileAgeLimitForManagedFolders <EnhancedTimeSpan>] [-LogFileSizeLimitForManagedFolders <Unlimited>] [-LogPathForManagedFolders <LocalLongFullPath>] [-ManagedFolderAssistantSchedule <ScheduleInterval[]>] [-MAPIEncryptionRequired <$true | $false>] [-MessageTrackingLogEnabled <$true | $false>] [-MessageTrackingLogMaxAge <EnhancedTimeSpan>] [-MessageTrackingLogMaxDirectorySize <Unlimited>] [-MessageTrackingLogMaxFileSize <Unlimited>] [-MessageTrackingLogPath <LocalLongFullPath>] [-MessageTrackingLogSubjectLoggingEnabled <$true | $false>] [-RedundantMachines <MultiValuedProperty>] [-ReplicationNetworks <PrivateOnly | PrivateThenMixed | AllNetworks>] [-RetentionLogForManagedFoldersEnabled <$true | $false>] [-SubjectLogForManagedFoldersEnabled <$true | $false>] [-SubmissionServerOverrideList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Set-MailboxServer [-AutoDatabaseMountDial <Lossless | GoodAvailability | BestAvailability>] [-ClusteredStorageType <Disabled | NonShared | Shared>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderLogForManagedFoldersEnabled <$true | $false>] [-ForcedDatabaseMountAfter <Unlimited>] [-Instance <MailboxServer>] [-JournalingLogForManagedFoldersEnabled <$true | $false>] [-Locale <MultiValuedProperty>] [-LogDirectorySizeLimitForManagedFolders <Unlimited>] [-LogFileAgeLimitForManagedFolders <EnhancedTimeSpan>] [-LogFileSizeLimitForManagedFolders <Unlimited>] [-LogPathForManagedFolders <LocalLongFullPath>] [-ManagedFolderAssistantSchedule <ScheduleInterval[]>] [-MAPIEncryptionRequired <$true | $false>] [-MessageTrackingLogEnabled <$true | $false>] [-MessageTrackingLogMaxAge <EnhancedTimeSpan>] [-MessageTrackingLogMaxDirectorySize <Unlimited>] [-MessageTrackingLogMaxFileSize <Unlimited>] [-MessageTrackingLogPath <LocalLongFullPath>] [-MessageTrackingLogSubjectLoggingEnabled <$true | $false>] [-RedundantMachines <MultiValuedProperty>] [-ReplicationNetworks <PrivateOnly | PrivateThenMixed | AllNetworks>] [-RetentionLogForManagedFoldersEnabled <$true | $false>] [-SubjectLogForManagedFoldersEnabled <$true | $false>] [-SubmissionServerOverrideList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Para executar o cmdlet Set-MailboxServer, você deve usar uma conta à qual esteja delegado o seguinte:
- Função de 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.
Para modificar as configurações de controle de mensagens em um servidor que tenha as funções de Caixa de Correio e Transporte de Hub instaladas, você poderá usar os parâmetros de controle de mensagens com o cmdlet Set-MailboxServer ou Set-TransportServer. Para modificar as configurações de controle de mensagens em um servidor que tenha a função de servidor Caixa de Correio, mas não a Transporte de Hub, instalada, use os parâmetros de controle de mensagens com o cmdlet Set-MailboxServer. Para modificar as configurações de controle de mensagens em um servidor que tenha a função de servidor Transporte de Hub, mas não a de Caixa de Correio, instalada, use os parâmetros de controle de mensagens com o cmdlet Set-TransportServer.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.MailboxServerIdParameter |
O parâmetro Identity especifica o servidor de Caixa de Correio. É possível usar os seguintes valores:
|
AutoDatabaseMountDial |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AutoDatabaseMountDial |
O parâmetro AutoDatabaseMountDial especifica o comportamento da montagem automática do banco de dados para uma solução de CCR (replicação contínua em cluster) após um failover do servidor de caixas de correio clusterizadas. É possível usar os seguintes valores:
O valor padrão é BestAvailability. Se você especificar BestAvailability ou GoodAvailability, e nenhum dado no nó ativo tiver sido replicado para o nó passivo, você poderá perder alguns dados da caixa de correio. No entanto, o recurso de dumpster de transporte (que é habilitado por padrão) ajudará a proteger contra a perda de dados, reenviando as mensagens que estão na fila de dumpster de transporte. Para obter mais informações sobre o dumpster de transporte, consulte Replicação Contínua em Cluster. Se especificar um desses valores fizer com que um banco de dados não seja montado após um failover, você poderá usar o parâmetro ForcedDatabaseMountAfter para forçar o banco de dados a ser montado após um período de tempo especificado. Para obter mais informações sobre os valores Lossless, GoodAvailability e BestAvailability, consulte Interrupções agendadas e não agendadas. |
ClusteredStorageType |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ClusteredStorageType |
O parâmetro ClusteredStorageType especifica o tipo de armazenamento compartilhado para um servidor de caixas de correio clusterizadas. É possível usar os seguintes valores:
|
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. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. |
FolderLogForManagedFoldersEnabled |
Opcional |
System.Boolean |
O parâmetro FolderLogForManagedFoldersEnabled especifica se o log da pasta de pastas gerenciadas está habilitado para mensagens movidas para pastas gerenciadas. Os dois valores possíveis para esse parâmetro são $true ou $false. Se você especificar $true, as informações sobre pastas com diretivas de caixa de correio de pasta gerenciada aplicadas a elas serão registradas. |
ForcedDatabaseMountAfter |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro ForcedDatabaseMountAfter especifica o tempo a ser aguardado após um failover do servidor de caixas de correio clusterizadas, antes da montagem automática dos bancos de dados. Para especificar um valor, insira-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 tempo limite de duas horas, insira 2:00:00. Caso você defina o parâmetro AutoDatabaseMountDial como GoodAvailability ou BestAvailability e o banco de dados tenha perdido um número de arquivos de log superior ao permitido com base no valor do parâmetro AutoDatabaseMountDial, o servidor da Caixa de Correio aguardará o tempo especificado pelo parâmetro ForcedDatabaseMountAfter para montar os bancos de dados automaticamente. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.MailboxServer |
O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando. Ele é incluído na tabela de parâmetros para referência do desenvolvedor. |
JournalingLogForManagedFoldersEnabled |
Opcional |
System.Boolean |
O parâmetro JournalingLogForManagedFoldersEnabled especifica se o log de pastas gerenciadas está habilitado para registro no diário. Os dois valores possíveis para esse parâmetro são $true ou $false. Se você especificar $true, as informações sobre mensagens registradas no diário serão registradas. Os logs estão localizados no local especificado com o parâmetro LogPathForManagedFolders. |
Locale |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro Locale especifica o locale. Um locale é uma coleção de preferências do usuário relacionadas ao idioma, como sistema de gravação, calendário e formato de data. A seguir, alguns exemplos:
Para obter uma lista completa, consulte CultureInfo Class. |
LogDirectorySizeLimitForManagedFolders |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro LogDirectorySizeLimitForManagedFolders especifica o limite de tamanho para todos os arquivos de log da pasta gerenciada a partir de um único banco de dados de mensagens. Depois que o limite for atingido para um conjunto de arquivos de log de pasta gerenciada de um banco de dados de mensagens, os arquivos mais antigos serão excluídos para disponibilizar espaço para novos arquivos. O tamanho dos arquivos de log de pasta gerenciada é calculado como o tamanho total de todos os arquivos de log que possuem o mesmo prefixo de nome. Por exemplo, para um arquivo com o nome Managed_Folder_Assistant[Storage Group 01][Mailbox Database 01]20061018-1.log, o prefixo é Managed_Folder_Assistant[Storage Group 01][Mailbox Database 01]. Se você renomear os arquivos de log ou copiar outros arquivos para o diretório de log da pasta gerenciada, esses arquivos não serão contados no cálculo de tamanho dos arquivos de log. Os arquivos de log da pasta gerenciada para cada banco de dados de mensagem possuem um prefixo de nome exclusivo. Portanto, esse limite aplica-se aos arquivos de log para cada banco de dados de mensagens e não a todos os arquivos de log do diretório. Se você tiver mais de um banco de dados de mensagens, o tamanho máximo do diretório de log da pasta gerenciada não será o tamanho especificado no parâmetro LogDirectorySizeLimitForManagedFolders, pois os arquivos de log da pasta gerenciada que são gerados por diferentes bancos de dados têm diferentes prefixos de nomes. O tamanho máximo do diretório de log da pasta gerenciada será X vezes o valor especificado, se você tiver X bancos de dados de mensagens. Você deve especificar um inteiro ou "ilimitado". O valor padrão é "ilimitado". Quando você inserir um valor, qualifique-o com uma das seguintes unidades:
Valores não qualificados são considerados bytes. |
LogFileAgeLimitForManagedFolders |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro LogFileAgeLimitForManagedFolders especifica por quanto tempo manter os logs de pastas gerenciadas. Os arquivos de log que excederem o período máximo de retenção são excluídos. Para especificar um valor, insira-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 30 dias, insira 30.00:00:00. O valor padrão é 00:00:00:00 (que especifica que não há limite na retenção de arquivos e não que os arquivos são substituídos imediatamente). |
LogFileSizeLimitForManagedFolders |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro LogFileSizeLimtiForManagedFolders especifica o tamanho máximo para cada arquivo de log de pastas gerenciadas. Quando o limite do tamanho do arquivo de log for atingido, um novo arquivo de log será criado. O valor padrão é 10 megabytes (MB). Quando você inserir um valor, qualifique-o com uma das seguintes unidades:
Valores não qualificados são considerados bytes. |
LogPathForManagedFolders |
Opcional |
Microsoft.Exchange.Data.LocalLongFullPath |
O parâmetro LogPathForManagedFolders especifica o caminho para o diretório que armazena arquivos de log de pastas gerenciadas. O valor padrão é <Caminho de instalação do Exchange>\Logging\Assistente de Pasta Gerenciada. |
ManagedFolderAssistantSchedule |
Opcional |
Microsoft.Exchange.Common.ScheduleInterval[] |
O parâmetro ManagedFolderAssistantSchedule especifica os intervalos semanais durante os quais o assistente de pasta gerenciada aplicará as configurações de gerenciamento de registro de mensagens às pastas gerenciadas. O formato é StartDay.Time-EndDay.Time. Você pode usar os seguintes valores para os dias de início e de término:
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:
Se o assistente de pasta gerenciada não concluir o processamento das caixas de correio no servidor durante o tempo agendado, ele continuará o processamento automaticamente no ponto em que parou na próxima vez em que for executado. |
MAPIEncryptionRequired |
Opcional |
System.Boolean |
O parâmetro MAPIEncryptionRequired especifica se o Exchange bloqueará clientes MAPI que não usam RPCs (chamadas de procedimento remoto) criptografadas. Os dois valores possíveis para esse parâmetro são $true ou $false. |
MessageTrackingLogEnabled |
Opcional |
System.Boolean |
O parâmetro MessageTrackingLogEnabled especifica se o controle de mensagens será habilitado. O valor padrão é $true. |
MessageTrackingLogMaxAge |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro MessageTrackingLogMaxAge especifica a idade máxima do arquivo de log de controle de mensagens. Os arquivos de log mais antigos do que o valor especificado são excluídos. O valor padrão é 30 dias. Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss, em que d = dias, h = horas, m = minutos e s = segundos. O intervalo de entrada válido para esse parâmetro é de |
MessageTrackingLogMaxDirectorySize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro MessageTrackingLogMaxDirectorySize especifica o tamanho máximo do diretório de log de controle de mensagens. Se o tamanho máximo de um diretório for atingido, o servidor excluirá primeiramente os arquivos de log mais antigos. O tamanho máximo do diretório de log de controle de mensagens é calculado como o tamanho total de todos os arquivos de log que tenham o mesmo prefixo de nome. Outros arquivos que não seguem a convenção de prefixo de nome não são considerados no cálculo do tamanho total do diretório. Renomear arquivos de log antigos ou copiar outros arquivos no diretório de log de controle de mensagens pode fazer com que o diretório exceda o tamanho máximo especificado. Quando as funções de servidor Transporte de Hub e Caixa de Correio estiverem instaladas no mesmo servidor, o tamanho máximo do diretório de log de controle de mensagens não será o tamanho máximo especificado, pois os arquivos de log de controle de mensagens que são gerados pelas diferentes funções de servidor têm prefixos de nomes diferentes. Os arquivos de log de controle de mensagens das funções de servidor Transporte de Hub ou Transporte de Borda começam com o prefixo de nome MSGTRK. Os arquivos de controle de mensagens da função de servidor Caixa de Correio começam com o prefixo de nome MSGTRKM. Quando as funções de servidor Transporte de Hub e Caixa de Correio estiverem instaladas no mesmo servidor, o tamanho máximo do diretório de log de controle de mensagens é duas vezes o valor especificado. O valor padrão é
Valores não qualificados são considerados bytes. O valor do parâmetro MessageTrackingLogMaxFileSize deve ser menor ou igual ao valor do parâmetro MessageTrackingLogMaxDirectorySize . O intervalo de entrada válido de ambos os parâmetros é de |
MessageTrackingLogMaxFileSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro MessageTrackingLogMaxFileSize especifica o tamanho máximo do arquivo de log de controle de mensagens. Quando o tamanho máximo do arquivo de log for atingido, um novo arquivo de log será criado. O valor padrão é 10 MB. Quando você inserir um valor, qualifique-o com uma das seguintes unidades:
Valores não qualificados são considerados bytes. O valor do parâmetro MessageTrackingLogMaxFileSize deve ser menor ou igual ao valor do parâmetro MessageTrackingLogMaxDirectorySize . O intervalo de entrada válida de qualquer parâmetro é de 1 a 9223372036854775807 bytes. |
MessageTrackingLogPath |
Opcional |
Microsoft.Exchange.Data.LocalLongFullPath |
O parâmetro MessageTrackingLogPath especifica o local dos logs de controle de mensagens. O local padrão é |
MessageTrackingLogSubjectLoggingEnabled |
Opcional |
System.Boolean |
O parâmetro MessageTrackingLogSubjectLoggingEnable especifica se o assunto da mensagem deve ser incluído no log de controle de mensagens. O valor padrão é $True. |
RedundantMachines |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro RedundantMachines especifica os proprietários possíveis e preferenciais para recursos do cluster. |
ReplicationNetworks |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReplicationNetworks |
O parâmetro ReplicationNetworks é um parâmetro reprovado que não funciona em Exchange Server 2007 RTM ou SP1. Você não deve utilizar esse parâmetro ao executar o cmdlet Set-MailboxServer. |
RetentionLogForManagedFoldersEnabled |
Opcional |
System.Boolean |
O parâmetro RetentionLogForManagedFoldersEnabled especifica se o assistente de pasta gerenciada registra informações sobre mensagens que atingiram seus limites de retenção. Os dois valores possíveis para esse parâmetro são $true ou $false. Se você especificar $true, as informações sobre mensagens que foram processadas porque atingiram seus limites de retenção serão registradas. |
SubjectLogForManagedFoldersEnabled |
Opcional |
System.Boolean |
O parâmetro SubjectLogForManagedFoldersEnabled especifica se o assunto das mensagens será exibido nos logs de pastas gerenciadas. Os dois valores possíveis para esse parâmetro são $true ou $false. Se você especificar $false, o assunto das mensagens ficará em branco nos logs de pastas gerenciadas. O valor padrão é $false. |
SubmissionServerOverrideList |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro SubmissionServerOverrideList consiste em uma lista estática de servidores de Transporte de Hub (que existe no mesmo site do Active Directory como o servidor de Caixa de Correio), que serão notificados pelo servidor de Caixa de Correio quando as mensagens estiverem prontas para recuperação da caixa de saída de um remetente. Essa lista substitui a dos servidores de Transporte de Hub descobertos de forma dinâmica e pode ser usada temporariamente na solução de problemas de um servidor de Transporte de Hub, quando você não desejar receber notificações de envio de emails, ou ainda para substituir o equilíbrio de carga automático de notificações dentre os servidores de Transporte de Hub, no mesmo site do Active Directory do servidor de Caixa de Correio. |
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
Neste exemplo, o comando Set-MailboxServer é usado para definir a lista de substituições de servidor para o HubServer01, o HubServer02 e o HubServer03.
Set-MailboxServer -Identity Server1 -SubmissionServerOverrideList HubServer01,HubServer02,HubServer03