Get-Message
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Get-Message per visualizzare i dettagli di uno o più messaggi in coda sui server Cassette postali o Trasporto Edge.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-Message
[-Filter <String>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-Server <ServerIdParameter>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]Get-Message
[[-Identity] <MessageIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]Get-Message
[-Queue <QueueIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]Descrizione
È possibile visualizzare i messaggi includendo il nome del server come parte dei parametri Identity o Queue oppure includendo il parametro Server con una query di filtro. Il parametro Identity, il parametro Queue e le impostazioni dei parametri Filter si escludono reciprocamente.
È 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
Get-Message -Filter "FromAddress -like '*@contoso.com'" | Format-ListIn questo esempio vengono visualizzate informazioni dettagliate su tutti i messaggi in coda sul server locale e ricevuti da qualunque mittente nel dominio contoso.com.
Esempio 2
Get-Message -Filter "FromAddress -like '*@contoso.com' -and SCL -gt 3"In questo esempio vengono elencati tutti i messaggi accodati nel server locale, ricevuti da qualsiasi mittente nel dominio contoso.com e con un valore SCL maggiore di 3.
Esempio 3
Get-Message -Server Server01.contoso.com -SortOrder: +FromAddress,-SizeIn questo esempio vengono visualizzati tutti i messaggi in coda sul server Server01. I risultati sono ordinati prima in ordine crescente per indirizzo del mittente, quindi in ordine decrescente per dimensione.
Parametri
-BookmarkIndex
Il parametro BookmarkIndex consente di specificare la posizione nell'insieme di risultati da cui iniziano i risultati visualizzati. Il valore del parametro è un indice in base 1 nel set di risultati totale. Il parametro BookmarkIndex non può essere utilizzato con il parametro BookmarkObject.
| Type: | Int32 |
| 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 |
-BookmarkObject
Il parametro BookmarkObject consente di specificare l'oggetto nell'insieme di risultati da cui iniziano i risultati visualizzati. Il parametro BookmarkObject non può essere utilizzato con il parametro BookmarkIndex.
| Type: | ExtensibleMessageInfo |
| 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 |
-Filter
Il parametro Filter consente di specificare uno o più messaggi usando la sintassi del filtro OPATH. Il filtro OPATH include un nome di proprietà del messaggio seguito da un operatore di confronto e da un valore (ad esempio, "FromAddress -like '*@contoso.com'"). Per informazioni dettagliate sulle proprietà dei messaggi filtrabili e sugli operatori di confronto, vedere Proprietà dei messaggi nelle code e Trovare code e messaggi nelle code in Exchange Management Shell.
È possibile specificare più criteri utilizzando l'operatore di confronto and. I valori di proprietà non espressi con un numero intero devono essere racchiusi tra virgolette (").
| Type: | String |
| 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeBookmark
Il parametro IncludeBookmark consente di specificare se includere l'oggetto segnalibro quando vengono visualizzati i risultati della query. Il parametro IncludeBookmark è valido quando viene utilizzato con i parametri BookmarkObject o BookmarkIndex. Se non si specifica un valore per il parametro IncludeBookmark, verrà utilizzato il valore predefinito $true.
| Type: | Boolean |
| 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 |
-IncludeComponentLatencyInfo
L'opzione IncludeComponentLatencyInfo specifica se le informazioni di latenza di componenti sono incluse nelle proprietà del messaggio. Con questa opzione non è necessario specificare alcun valore.
Se si include questa opzione, gli oggetti del messaggio restituiti includeranno le misurazioni di latenza per ciascuna componente di trasporto che ha contribuito alla latenza del server locale per ogni messaggio in coda.
| Type: | SwitchParameter |
| 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 |
-IncludeRecipientInfo
L'opzione IncludeRecipientInfo consente di specificare se visualizzare i destinatari del messaggio nel campo Destinatari. Con questa opzione non è necessario specificare alcun valore.
Se non si include l'opzione IncludeRecipientInfo, il campo Destinatari è vuoto.
L'archiviazione dei risultati di un Get-Message -IncludeRecipientInfo comando in una variabile consente di visualizzare proprietà aggiuntive per i destinatari del messaggio. Il seguente elenco descrive le proprietà dei destinatari disponibili:
- Indirizzo: L'indirizzo di posta elettronica del destinatario.
- Tipo: tipo di destinatario, che può essere Esterno, Cassetta postale o Gruppo di distribuzione. Il Gruppo di distribuzione viene utilizzato quando la destinazione è un server di espansione.
- FinalDestination: Il nome distinto dell'oggetto che viene utilizzato per il routing del messaggio.
- Stato: lo stato del destinatario può essere Completo, Pronto o Riprova.
- LastError: La risposta SMTP dopo l'ultimo tentativo di recapitare il messaggio oppure un messaggio di errore localizzato se il messaggio viene inserito in una coda di messaggi con destinazioni non raggiungibili.
Ad esempio, per archiviare le informazioni sul destinatario di un messaggio nel contoso.com coda di recapito remoto con valore MessageIdentity pari a 1234 in una variabile denominata $x, usare il comando seguente: $x=Get-Message -Identity "contoso.com\\1234" -IncludeRecipientInfo.
Per visualizzare le proprietà del destinatario estese ora archiviate nella variabile $x, usare il comando seguente: $x.Recipients.
| Type: | SwitchParameter |
| 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 |
-Queue
Il parametro Queue consente di specificare l'identità della coda contenente i messaggi che si desidera visualizzare. L'input valido per questo parametro usa la sintassi <Server>\<Queue> o <Queue>, ad esempio Mailbox01\contoso.com o Unreachable. Per informazioni dettagliate sull'identità della coda, vedere la sezione "Identità coda" in Trovare code e messaggi nelle code in Exchange Management Shell.
Se si utilizza il parametro Queue, non è possibile utilizzare i parametri Identity, Filter o Server.
| Type: | QueueIdentity |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.
| Type: | Unlimited |
| 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 |
-ReturnPageInfo
Il parametro ReturnPageInfo è un parametro nascosto. Usarlo per restituire informazioni sul numero totale di risultati e sull'indice del primo oggetto della pagina corrente. Il valore predefinito è $false.
| Type: | Boolean |
| 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 |
-SearchForward
Il parametro SearchForward consente di specificare se cercare in avanti o all'indietro nell'insieme di risultati. Il valore predefinito è $true. Questo valore consente di calcolare la pagina dei risultati in avanti dall'inizio del set di risultati o di un eventuale segnalibro specificato.
| Type: | Boolean |
| 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 |
-Server
Il parametro Server specifica il server Exchange in cui si vuole eseguire il comando. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- FQDN
- Nome distinto (DN)
- DN legacy di Exchange
DN legacy di Exchange
È possibile utilizzare il parametro Server e il parametro Filter nello stesso comando. Non è possibile utilizzare il parametro Server e il parametro Identity nello stesso comando.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SortOrder
Il parametro SortOrder consente di specificare una matrice di proprietà dei messaggi utilizzate per controllare l'ordinamento dell'insieme di risultati. Separare ciascuna proprietà utilizzando una virgola. Aggiungere un simbolo + all'inizio del nome della proprietà per visualizzare i risultati in ordine crescente. Aggiungere un simbolo - all'inizio del nome della proprietà per visualizzare i risultati in ordine decrescente.
Se non viene specificato un criterio di ordinamento, il set di risultati viene visualizzato in ordine crescente in base al valore di MessageIdentity.
| Type: | QueueViewerSortOrderEntry[] |
| 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.