Condividi tramite

Get-Message

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2007-08-29

Il cmdlet Get-Message consente di visualizzare i dettagli di uno o più messaggi presenti in una coda in un computer in cui è installato il ruolo del server Trasporto Hub o Trasporto Edge.

Sintassi

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-Identity <MessageIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-Queue <QueueIdentity>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Descrizione dettagliata

Il cmdlet Get-Message consente di visualizzare i dettagli di uno o più messaggi presenti in una coda esistente nel server Trasporto Hub o Trasporto Edge. Se non vengono forniti parametri, il comando esegue una query in tutti i messaggi delle code sul server locale e restituisce una singola pagina di risultati. La dimensione predefinita della pagina è 1.000 oggetti. È possibile visualizzare messaggi in un server remoto includendo il nome del server come parte del parametro Identity o Queue oppure includendo nel parametro Server una query del filtro. I set di parametri Identity, Queue e Filter si escludono a vicenda.

Per eseguire il cmdlet Get-Message, è necessario utilizzare un account che disponga della delega del ruolo Exchange Server Administrators.

Per eseguire il cmdlet Get-Message in un computer in cui è stato installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account che sia membro del gruppo Administrators locale del computer.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

BookmarkIndex

Facoltativo

System.Int32

Utilizzare il parametro BookmarkIndex per specificare la posizione nel set di risultati da cui iniziano i risultati visualizzati. Il valore del parametro è un indice in base 1 nel set di risultati totale. BookmarkIndex non può essere utilizzato con il parametro BookmarkObject.

BookmarkObject

Facoltativo

Microsoft.Exchange.Data.QueueViewer.MessageInfo

Utilizzare il parametro BookmarkObject per specificare l'oggetto nel set di risultati in cui iniziano i risultati visualizzati. BookmarkObject non può essere utilizzato con il parametro BookmarkIndex.

Filter

Facoltativo

System.String

Il parametro Filter richiede un'espressione che specifica i criteri del valore di proprietà per i messaggi da visualizzare. L'espressione include un nome di proprietà seguito da un operatore di confronto e da un valore. Le seguenti proprietà del messaggio sono criteri validi per il parametro Filter:

  • DateReceived   Data di ricezione del messaggio.

  • ExpirationTime   Ora di scadenza del messaggio.

  • FromAddress   Indirizzo SMTP del mittente del messaggio. Questo valore viene ricavato da MAIL FROM: nella busta del messaggio.

  • Identity   Numero intero che rappresenta un messaggio particolare, un server facoltativo e l'identità della coda.

  • InternetMessageId   Il valore del campo dell'intestazione Message-ID:. Questa proprietà viene espressa come un GUID seguito dall'indirizzo SMTP del server mittente, come in questo esempio: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com.

  • LastError   Stringa di testo dell'ultimo errore registrato per il messaggio.

  • MessageSourceName   Stringa di testo del nome del componente che ha inviato il messaggio alla coda.

  • Queue   Specifica l'identità della coda che include il messaggio. Immettere l'identità della coda nel formato Server\destinazione, dove destinazione è un dominio remoto, un server cassette postali o il nome della coda permanente.

  • RetryCount   Numero di tentativi di recapito di un messaggio a destinazione.

  • SCL   La proprietà SCL specifica il livello di probabilità di posta indesiderata del messaggio. I valori SCL validi sono i numeri interi da 0 a 9. Una proprietà SCL vuota indica che il messaggio non è stato elaborato dall'agente filtro contenuto.

  • Size   Dimensione di un messaggio.

  • SourceIP   Indirizzo IP del server esterno che ha inviato il messaggio all'organizzazione di Exchange.

  • Status   Stato corrente del messaggio. Le opzioni per lo stato del messaggio sono Active, Retry, Suspended, PendingSuspend e PendingRemove.

  • Subject   Stringa di testo che rappresenta l'oggetto del messaggio di posta elettronica. Il valore viene ricavato dal campo dell'intestazione Subject:.

È possibile specificare più criteri per il filtro utilizzando l'operatore di confronto - and. I valori della proprietà non composti da un numero intero singolo devono essere racchiusi dalle virgolette.

Identity

Facoltativo

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Utilizzare il parametro Identity per specificare il numero intero per MessageIdentity. Tale numero rappresenta un messaggio particolare, un server facoltativo e l'identità della coda. La sintassi del parametro può essere specificata come segue:

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

IncludeBookmark

Facoltativo

System.Boolean

Utilizzare il parametro IncludeBookmark per specificare se includere l'oggetto segnalibro quando vengono visualizzati i risultati della query. Il parametro IncludeBookmark è valido se utilizzato con il parametro BookmarkObject o BookmarkIndex. Se non si specifica un valore per il parametro IncludeBookmark, verrà utilizzato il valore predefinito $true.

IncludeRecipientInfo

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro IncludeRecipientInfo consente di visualizzare i destinatari del messaggio nel campo Destinatari. Se non si include il parametro IncludeRecipientInfo, il campo dei destinatari rimane vuoto.

L'archiviazione dei risultati di un comando Get-Message -IncludeRecipientInfo in una variabile consente di visualizzare proprietà aggiuntive per i destinatari dei messaggi. Il seguente elenco descrive le proprietà dei destinatari disponibili:

  • Indirizzo   L'indirizzo di posta elettronica del destinatario

  • Tipo   Il tipo di destinatario può essere Esterno, Cassetta postale o LD. LD viene utilizzato quando la destinazione è un server di espansione.

  • FinalDestination   Il nome distinto (DN, distinguished name) dell'oggetto che viene utilizzato per indirizzare il messaggio. L'oggetto potrebbe essere un connettore, un server di cassette postali o un server di espansione.

  • 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 sui destinatari di un messaggio nella coda di recapito remoto "Contoso.com" con un valore di MessageIdentity pari a 1234 in una variabile denominata $x, utilizzare il seguente comando:

$x=Get-Message -Identity "Contoso.com\1234" -IncludeRecipientInfo

Per visualizzare le proprietà estese dei destinatari attualmente archiviate nella variabile $x, utilizzare il seguente comando:

$x.Recipients

Queue

Facoltativo

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Utilizzare il parametro Queue per specificare l'identità della coda contenente i messaggi che si desidera visualizzare. Immettere l'identità della coda nel formato Server\destinazione, dove destinazione è un dominio remoto, un server cassette postali o il nome della coda permanente.

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Utilizzare il parametro ResultSize per specificare il numero totale di elementi da visualizzare nel set di risultati. Il valore predefinito per il parametro ResultSize è impostato su 1.000. ResultSize supporta un numero illimitato di risultati, tuttavia in Microsoft Exchange il set di risultati è limitato a 250.000.

ReturnPageInfo

Facoltativo

System.Boolean

ReturnPageInfo è un parametro nascosto che consente di ottenere informazioni sul numero totale di risultati e sull'indice del primo oggetto della pagina corrente. Il valore predefinito è $false.

SearchForward

Facoltativo

System.Boolean

Utilizzare il parametro SearchForward per specificare se cercare in avanti o all'indietro nel set 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.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Utilizzare il parametro Server per specificare il nome del server da connettere utilizzando una chiamata RPC che contiene le code in cui sono presenti i messaggi da visualizzare. Immettere il parametro Server come nome host o nome di dominio completo (FQDN). Se questo parametro non viene utilizzato, viene eseguita una query al server locale.

SortOrder

Facoltativo

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

Utilizzare il parametro SortOrder per specificare una matrice di proprietà del messaggio che vengono utilizzate per controllare l'ordinamento del set 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 ordinamento, il set di risultati viene visualizzato in ordine crescente in base al numero intero MessageIdentity.

Esempio

Nei seguenti esempi viene illustrato come eseguire query relative ai messaggi utilizzando il comando Get-Message. Nel primo esempio viene illustrato come visualizzare tutti i messaggi accodati sul server locale e ricevuti da un mittente nel dominio specificato. Il comando viene reindirizzato al comando Format-List per formattare i risultati come un elenco dettagliato.

Nel secondo esempio viene illustrato come visualizzare tutti i messaggi accodati sul server locale, ricevuti da un mittente nel dominio specificato e con un valore SCL superiore a 3.

Nel terzo esempio viene illustrato come connettersi a un server remoto e come visualizzare tutti i messaggi accodati su tale server in base all'ordinamento specificato. I risultati sono ordinati prima in ordine crescente per indirizzo del mittente, quindi in ordine decrescente per dimensione.

Per ulteriori informazioni sul pipelining, vedere Pipelining.

Per ulteriori informazioni su come utilizzare l'output di un comando, vedere Utilizzo dell'output di comando.

Per ulteriori informazioni su come utilizzare Exchange Management Shell per eseguire le attività del Visualizzatore code, vedere Utilizzo di Exchange Management Shell per la gestione delle code.

Get-Message -Filter {FromAddress -like "*@contoso.com"} | format-list
Get-Message -Filter {FromAddress -like "*@contoso.com" -and SCL -gt 3}
Get-Message -Server exchange.contoso.com -SortOrder: +FromAddress,-Size