Export-Message
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-06-28
Use o cmdlet Export-Message para copiar uma mensagem de uma fila em um computador em que a função de servidor Tranporte de Hub ou Transporte de Borda esteja instalada para um caminho de arquivo especificado em uma organização do Microsoft Exchange Server 2007.
Sintaxe
Export-Message -Identity <MessageIdentity> -Path <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Export-Message copia mensagens de uma fila de entrega, a fila Inacessível, ou a fila de mensagens suspeitas em um servidor de Transporte de Hub ou um servidor de Transporte de Borda para um caminho de arquivo especificado. Antes de exportar uma mensagem, você deve primeiro suspendê-la. Mensagens da fila de mensagens suspeitas já estão suspensas. Você pode usar o comando Export-Message para copiar mensagens para o diretório de repetição de outro servidor de transporte para entrega. Para copiar uma mensagem que esteja localizada em um servidor remoto, inclua o nome do servidor como parte da identidade da mensagem. A identidade é obrigatória e deve identificar com exclusividade uma mensagem em uma fila.
Para executar o cmdlet Export-Message, você deve usar a conta à qual esteja delegado o seguinte:
- Função Administrador do Exchange Server e grupo Administradores local para o servidor de destino
Para executar o cmdlet Export-Message em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve efetuar logon com uma conta que seja membro do grupo Administradores local nesse 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 |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Use o parâmetro Identity para especificar inteiro MessageIdentity. Esse é um número inteiro que representa uma determinada mensagem e uma identidade de servidor e de fila opcional. A sintaxe deste parâmetro é a seguinte:
|
Path |
Necessário |
System.String |
Use o parâmetro Path para especificar o caminho do arquivo para o qual a mensagem será exportada. O valor do parâmetro Path pode ser um nome de arquivo, um diretório e um nome de arquivo ou apenas um diretório. O diretório de destino deve existir para que você exporte mensagens. O diretório não será criado para você. Se um caminho absoluto não for especificado, o diretório de trabalho atual do Shell de Gerenciamento do Exchange será usado. Os diretórios usados no parâmetro Path podem ser locais para o computador do Exchange 2007 ou podem ser um caminho UNC (Convenção Universal de Nomenclatura) para um compartilhamento em um servidor remoto. Se você especificar um diretório existente sem um nome de arquivo no valor do parâmetro Path, os nomes dos arquivos de mensagens serão automaticamente definidos como InternalMessageID.eml. O InternalMessageID é um identificador de mensagens atribuído pelo servidor Exchange 2007 que está atualmente processando a mensagem. Sua conta deve ter permissão de gravação no diretório de destino. |
Confirm |
Optional |
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. |
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
Os exemplos a seguir mostram como exportar mensagens de uma fila para um arquivo. O primeiro exemplo mostra como exportar uma única mensagem para o caminho de arquivo especificado.
O segundo exemplo mostra como usar o comando Get-Message para recuperar todas as mensagens da fila especificada. Os resultados da consulta são canalizados para o comando Export-Message e todas as mensagens são copiadas para arquivos .eml com nomes baseados em InternalMessageID.
Para obter mais informações sobre como usar o Shell de Gerenciamento do Exchange para executar tarefas do visualizador de filas, consulte Usando o Shell de Gerenciamento do Exchange para gerenciar filas.
Export-Message -Identity ExchSrv1\contoso.com\1234 -Path "c:\exportfolder\filename.eml"
Get-Message -Queue "Server1\contoso.com" | Export-Message -Path "c:\exportfolder"