Set-SystemMessage

Artigo
09/30/2014

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

Exceçõ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."

Compartilhar via