Export-Message
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
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. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. 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
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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
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.
Type: | MessageIdentity |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.