Condividi tramite

Export-Message

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Export-Message per copiare un messaggio da una coda su un server Cassette postali o un server Trasporto Edge in un percorso di file specificato nell'organizzazione.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (impostazione predefinita). 

Export-Message
    [-Identity] <MessageIdentity>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet Export-Message consente di copiare i messaggi dalla coda di recapito, dalla coda dei messaggi irraggiungibili o dalla coda dei messaggi non elaborabili su un server Cassette postali o un server Trasporto Edge in un percorso di file specificato. Prima di esportare un messaggio, è necessario prima sospenderlo. I messaggi nella coda Non elaborabili sono già sospesi. È possibile utilizzare il cmdlet Export-Message per copiare i messaggi nella directory di riesecuzione di un altro server Cassette postali per il recapito.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Export-Message ExchSrv1\contoso.com\1234 | AssembleMessage -Path "c:\exportfolder\filename.eml"

In questo esempio viene esportato un singolo messaggio nel percorso del file specificato. Dato che il cmdlet Export-Message restituisce un oggetto binario, si deve utilizzare il filtro AssembleMessage per salvare il contenuto del messaggio nella locazione specificata.

Esempio 2

Get-Message -Queue "Server1\contoso.com" -ResultSize Unlimited | ForEach-Object {Suspend-Message $_.Identity -Confirm:$False

$Temp="C:\ExportFolder\"+$_.InternetMessageID+".eml"

$Temp=$Temp.Replace("<","_")

$Temp=$Temp.Replace(">","_")

Export-Message $_.Identity | AssembleMessage -Path $Temp}

In questo esempio vengono recuperati tutti i messaggi dalla coda specificata. I risultati della query vengono quindi reindirizzati al comando Export-Message e tutti i messaggi vengono copiati nei singoli file .EML. Gli ID di messaggio internet di ogni messaggio vengono utilizzati come nomi di file. A tale scopo, eseguire il comando riportato di seguito:

  • Recuperare tutti i messaggi in una coda specifica utilizzando il cmdlet Get-Message.
  • Il risultato viene reindirizzato al cmdlet ForEach-Object, che prepara un nome file comprensivo del percorso completo utilizzando la variabile temporanea $Temp, costituita dall'ID del messaggio Internet con estensione EML. Il campo ID messaggio Internet contiene parentesi angolate (< e >) che devono essere rimosse perché sono nomi di file non validi. Questo risultato si ottiene utilizzando il metodo Replace della variabile temporanea.
  • Il cmdlet ForEach-Object consente inoltre di esportare il messaggio utilizzando il nome file preparato.

Parametri

-Confirm

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro Identity consente di specificare il messaggio. L'input valido per questo parametro utilizza la sintassi Server\Queue\MessageInteger o Queue\MessageInteger o MessageInteger, per esempio, Mailbox01\contoso.com\5 o 10. Per informazioni dettagliate sull'identità del messaggio, vedere Identità del messaggio.

Proprietà dei parametri

Tipo:MessageIdentity
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.