New-SystemMessage
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-07-27
Use o cmdlet New-SystemMessage no Microsoft Exchange Server 2007 para criar novas mensagens DSN (Notificação de Status de Entrega) ou de cota personalizadas, no idioma especificado, em computadores com a função de servidor Transporte de Hub ou Transporte de Borda instalada.
Sintaxe
New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false> -Language <CultureInfo> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | WarningPublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSendReceiveMailBox> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Esse cmdlet permite criar novas 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.
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. Esse 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 New-SystemMessage, você deve usar uma conta à qual esteja delegado o seguinte:
- Função Administrador da Organização do Exchange
Para executar o cmdlet New-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 |
|---|---|---|---|
DsnCode |
Necessário |
Microsoft.Exchange.Data.EnhancedStatusCode |
Esse parâmetro especifica a qual código de notificação de status de entrega a mensagem se aplica. Esse parâmetro pode ser um código interno ou um código personalizado definido pelo administrador. Dica Este parâmetro não é necessário e não pode ser usado quando o parâmetro QuotaMessageType for especificado. |
Internal |
Necessário |
System.Boolean |
Esse parâmetro especifica se a mensagem é exibida para usuários que estão dentro da organização do Exchange Server. Para mensagens que são exibidas somente internamente, insira Dica Este parâmetro não é necessário e não pode ser usado quando o parâmetro QuotaMessageType for especificado. |
Language |
Necessário |
System.Globalization.CultureInfo |
Esse parâmetro especifica o idioma da mensagem. A mensagem pode ser criada em qualquer idioma com suporte para o Exchange Server. Os idiomas são especificados pelo uso do nome da localidade. Por exemplo, inglês é "en". Japonês é "ja". Para obter uma lista completa de localidades, consulte Localidades com suporte para uso com mensagens do sistema. |
QuotaMessageType |
Necessário |
Microsoft.Exchange.Data.Directory.SystemConfiguration.QuotaMessageType |
Esse parâmetro seleciona o tipo de mensagem de cota a ser criada. O parâmetro QuotaMessageType aceita os seguintes valores:
Dica Esse parâmetro não é necessário e não pode ser usado quando o parâmetro DsnCode for especificado. |
Text |
Necessário |
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. |
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 recupera dados do 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). |
WhatIf |
Optional |
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 código de exemplo a seguir, o primeiro exemplo adiciona uma nova mensagem DSN personalizada que tenha o código DSN 5.3.5. Essa mensagem DSN será exibida somente para usuários externos. O texto para a mensagem DSN é incluído na linha de comando, junto com o idioma da mensagem, inglês.
O segundo exemplo adiciona uma nova mensagem de cota WarningMailbox personalizada. Essa mensagem será exibida aos usuários que atendem aos seguintes critérios:
A caixa de correio excedeu o limite de avisos de caixas de correio configurado na caixa de correio.
Não há cota de caixa de correio de proibição de envio ou de proibição de recebimento configurada.
A caixa de correio está localizada em um servidor que usa a localidade Inglês.
New-SystemMessage -DsnCode 5.3.5 -Language En -Internal $false -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
New-SystemMessage -QuotaMessageType WarningMailbox -Language En -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."