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
Filter
Get-Message
[-Filter <String>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-Server <ServerIdParameter>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]
Identity
Get-Message
[[-Identity] <MessageIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]
Queue
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. 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
Get-Message -Filter "FromAddress -like '*@contoso.com'" | Format-List
In 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,-Size
In 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
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-BookmarkObject
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | ExtensibleMessageInfo |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-Filter
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Filter
| 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.
Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se fosse stato eseguito il comando Get- senza il parametro Identity. Verificare che gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.
Proprietà dei parametri
| Tipo: | MessageIdentity |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IncludeBookmark
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-IncludeComponentLatencyInfo
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 messaggio restituiti includono misure di latenza per ogni componente trasporto che ha contribuito alla latenza del server locale per ogni messaggio in coda.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-IncludeRecipientInfo
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 potrebbe 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-Queue
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | QueueIdentity |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Queue
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ResultSize
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-ReturnPageInfo
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-SearchForward
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-Server
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | ServerIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Filter
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-SortOrder
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | QueueViewerSortOrderEntry[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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.