Get-SystemMessage
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 Get-SystemMessage no Microsoft Exchange Server 2007 para exibir as mensagens notificação de status de entrega ou de cota em computadores em que a função de servidor Transporte de Hub ou Transporte de Borda esteja instalada.
Sintaxe
Get-SystemMessage [-Identity <SystemMessageIdParameter>] [-DomainController <Fqdn>]
Get-SystemMessage [-DomainController <Fqdn>] [-Original <SwitchParameter>]
Descrição detalhada
Esse cmdlet permite exibir mensagens DSN e de cota padrão e 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.
Para recuperar uma mensagem DSN ou de cota personalizada, especifique a identidade da mensagem usando o parâmetro Identity. Você pode recuperar uma lista de mensagens DSN ou de cota internas usando o parâmetro Original.
Dica
Você não pode especificar os parâmetros Original e Identity no mesmo comando.
Para executar o cmdlet Get-SystemMessage, você deve usar uma conta à qual esteja delegada seguinte função:
- Função de Administrador da Organização do Exchange
Para executar o cmdlet Get-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 Server 2007, consulte Considerações sobre permissão.
Parâmetros
Parâmetro | Necessário | Tipo | Descrição |
---|---|---|---|
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 lê somente na instância local do ADAM (Active Directory Application Mode). |
Identity |
Opcional |
Microsoft.Exchange.Configuration.Tasks.SystemMessageIdParameter |
Este parâmetro especifica a identidade da mensagem DSN ou de cota. Você também pode recuperar uma mensagem DSN personalizada usando 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. Você também pode recuperar uma mensagem de cota personalizada usando 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:
Você pode omitir o rótulo do parâmetro Identity. |
Original |
Opcional |
System.Management.Automation.SwitchParameter |
Esse parâmetro permite recuperar a lista de mensagens DSN ou de cota padrão que foram incluídas no Exchange 2007 quando você instalou o Exchange 2007. |
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 mostra como você pode exibir uma lista resumida de todas as mensagens DSN e de cota personalizadas configuradas no servidor.
O segundo exemplo mostra como você pode exibir a configuração detalhada de uma mensagem DSN personalizada específica canalizando a saída do cmdlet Get-SystemMessage para o cmdlet Format-List.
O terceiro exemplo mostra como você pode exibir a configuração detalhada de uma mensagem de cota personalizada específica canalizando a saída do cmdlet Get-SystemMessage para o cmdlet Format-List.
O quarto exemplo mostra como exibir uma lista de todas as mensagens DSN e de cota internas.
Para obter mais informações sobre pipeline, consulte Pipelining. Para obter mais informações sobre como trabalhar com a saída de um cmdlet, consulte Trabalhando com saída do comando.
Get-SystemMessage
Get-SystemMessage En\Internal\5.3.2 | Format-List
Get-SystemMessage En\WarningMailbox | Format-List
Get-SystemMessage -Original