Compartilhar via

Set-SystemMessage

  • Artigo

 

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

Tópico modificado em: 2007-09-05

Use o cmdlet Set-SystemMessage no Microsoft Exchange Server 2007 para modificar mensagens personalizadas de notificação de status de entrega ou de cota existentes, no idioma especificado, em computadores em que a função de servidor Transporte de Hub ou Transporte de Borda esteja instalada.

Sintaxe

Set-SystemMessage -Identity <SystemMessageIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>] [-WhatIf [<SwitchParameter>]]

Set-SystemMessage [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <SystemMessage>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Esse cmdlet permite que você modifique mensagens DSN e de cota personalizadas. As mensagens DSN são emitidas para o remetente de mensagens de email que não atingiram os destinatários pretendidos. As mensagens de cota são emitidas para usuários cujas caixas de correio ou pastas públicas atingiram as cotas específicas de aviso, proibição de envio ou proibição de recebimento. As mensagens DSN e de cota personalizadas substituem as mensagens DSN ou de cota internas incluídas no Exchange Server.

Observação   O servidor Exchange é pré-configurado com várias mensagens DSN padrão, que você não pode modificar usando esse cmdlet. Em vez disso, você deve criar uma nova mensagem DSN, com o mesmo código de DSN, para substituir as mensagens pré-configuradas.

A lista a seguir descreve as condições de erro que acionam mensagens DSN que tenham um status de entrega de falha temporária persistente e de falha permanente.

  • Mensagens DSN 4.X.X.   Este tipo de mensagem DSN é gerado quando há um problema temporário com a caixa de correio ou o servidor do destinatário. Geralmente, esses problemas são resolvidos por si mesmos e permitem a entrega bem-sucedida da mensagem de email. Um exemplo de um problema de falha temporária persistente 4.X.X. é um servidor que tenha ficado offline e não possa ser alcançado.

  • Mensagens DSN 5.X.X.   Este tipo de mensagem DSN é gerado quando ocorre um erro fatal ou permanente com a caixa de correio ou o servidor do destinatário. Tais erros não podem ser superados pelo servidor remetente de email e, portanto, a mensagem de email será retornada ao remetente. Um exemplo de erro de falha permanente 5.X.X. é um endereço SMTP inexistente.

Para executar o cmdlet Set-SystemMessage, você deve usar a conta à qual esteja delegado o seguinte:

  • Função Administrador da Organização do Exchange

Para executar o cmdlet Set-SystemMessage em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no computador.

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

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.SystemMessageIdParameter

Esse parâmetro especifica a identidade da mensagem DSN ou de cota a ser modificada.

Para modificar uma mensagem DSN, use o seguinte formato: idioma\interno | externo\código do sistema. Para obter mais informações sobre a sintaxe da identidade da mensagem DSN, consulte Identidade de uma mensagem DSN.

Para modificar uma mensagem de cota personalizada, use o seguinte formato: idioma\QuotaMessageType. O Idioma é expresso como um código de localidade de dois caracteres. O parâmetro QuotaMessageType aceita os seguintes valores:

  • WarningMailboxUnlimitedSize   Emitido quando uma caixa de correio que não tenha cota de proibição de envio ou cota de proibição de recebimento excede o limite de avisos de caixas de correio especificado.

  • WarningPublicFolderUnlimitedSize    Emitido quando uma pasta pública que não tenha cota de proibição de envio ou cota de proibição de recebimento, excede o limite de avisos de pastas públicas especificado.

  • WarningMailbox    Emitido quando uma caixa de correio que tenha cota de proibição de envio ou cota de proibição de recebimento excede o limite de avisos de caixas de correio especificado.

  • WarningPublicFolder    Emitido quando uma pasta pública que tenha cota de proibição de envio ou cota de proibição de recebimento excede o limite de avisos de pastas públicas especificado.

  • ProhibitSendMailbox    Emitido quando uma caixa de correio que tenha uma cota de proibição de envio excede o limite de tamanho de caixa de correio especificado.

  • ProhibitPostPublicFolder     Emitido quando uma pasta pública que tem uma cota de proibição de envio excede o limite de tamanho da pasta pública especificada.

  • ProhibitSendReceiveMailBox    Emitido quando uma caixa de correio que tenha cota de proibição de envio e cota de proibição de recebimento excede o limite de tamanho de envio e recebimento da caixa de correio especificado.

Você pode omitir o rótulo do parâmetro Identity.

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 dados no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda grava e lê somente na instância local do Active Directory Application Mode (ADAM).

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SystemMessage

Esse parâmetro permite passar a mensagem DSN ou de cota para o comando para ser processada. Esse parâmetro é útil em scripts em que um objeto inteiro deve ser passado para o comando.

Name

Opcional

System.String

Esse parâmetro especifica um nome que você pode usar para descrever a mensagem DSN ou de cota.

Original

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro reverte o texto da mensagem de notificação de status de entrega ou de cota novamente para o texto original fornecido. Esse parâmetro é útil quando você não deseja remover a entrada personalizada de notificação de status de entrega ou de cota, mas deseja reverter para o texto original.

Text

Opcional

System.String

Este parâmetro especifica o texto da mensagem que é exibida para os remetentes ou proprietários de caixas de correio. O texto deve explicar por que a mensagem foi criada e quais ações o remetente ou o proprietário da caixa de correio deve executar, se houver.

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 um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

No exemplo de código a seguir, o primeiro exemplo modifica o texto em inglês de uma mensagem DSN personalizada existente que tem o código DSN 5.3.5. Essa mensagem DSN só é exibida para usuários externos. O texto da mensagem DSN é incluído na linha de comando.

O segundo exemplo modifica o texto em inglês de uma mensagem de cota WarningMailbox personalizada existente.

Set-SystemMessage En\Internal\5.3.5 -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."