Utilizzo di Exchange Management Shell per la gestione delle code
Si applica a: Exchange Server 2013
Come nelle versioni precedenti di Exchange, è possibile utilizzare Exchange Management Shell in Microsoft Exchange Server 2013 per visualizzare le informazioni sulle code e i messaggi in tali code e per eseguire azioni di gestione su code e messaggi. In Exchange 2013, le code si trovano nei server Cassette postali e Trasporto Edge. In questo argomento viene fatto riferimento ai server di trasporto.
Quando si utilizza Shell per visualizzare e gestire le code e i messaggi in coda sui server di trasporto, è importante capire come identificare le code o i messaggi che si intende gestire. In genere, i server di trasporto contengono un gran numero di code e messaggi da consegnare. Si utilizzano i parametri di filtro che sono disponibili sulla coda e sui cmdlet di gestione dei messaggi per identificare le code o i messaggi che si intendono visualizzare o gestire.
È anche possibile utilizzare il Visualizzatore code nella casella degli strumenti di Exchange per la gestione di code e messaggi in coda. Tuttavia, la coda e i cmdlet di visualizzazione messaggio supportano le proprietà valide per il filtro e le opzioni di filtro del Visualizzatore code. Per ulteriori informazioni sul Visualizzatore code, vedere Visualizzatore code.
Parametri filtro della coda
Nella tabella seguente vengono descritti i parametri di filtro disponibili sui cmdlet di gestione delle code.
| Cmdlet | Parametri di filtro | Commenti |
|---|---|---|
| Get-Queue |
Identità Filter Includi Exclude |
Non è possibile utilizzare il parametro Identity nello stesso comando con i parametri Filter. È possibile utilizzare il parametro Include e i parametri Exclude con il parametro Filter nello stesso comando. |
|
Resume-Queue Retry-Queue Suspend-Queue |
Identità Filter |
È necessario utilizzare il parametro Identity o Filter, sebbene non sia possibile farlo nello stesso comando. |
| Get-QueueDigest |
Server Dag Site Foresta Filter |
È necessario utilizzare il parametro Server, Dag, Site oppure il parametro Forest, sebbene non sia possibile utilizzarli insieme nello stesso comando. È possibile utilizzare il parametro Filter con uno degli altri parametri di filtro. |
Si noti che un parametro Server è disponibile in tutti i cmdlet di gestione delle code. Nel cmdlet Get-QueueDigest il parametro Server è un parametro di ambito che specifica il server o i server in cui si desidera visualizzare le informazioni di riepilogo sulle code. In tutti gli altri cmdlet di gestione delle code, usare il parametro Server per connettersi a un server specifico ed eseguire i comandi di gestione delle code in tale server. È possibile usare il parametro Server con o senza il parametro Filter , ma non è possibile usare il parametro Server con il parametro Identity . Usare il nome host o il nome di dominio completo del server di trasporto con il parametro Server .
Identità delle code
Il parametro Identity sui cmdlet della code identifica una coda specifica. Quando si usa il parametro Identity , non è possibile specificare altri parametri di filtro delle code, perché la coda è già stata identificata in modo univoco. Il parametro Identity usa la sintassi <di base Coda>>server<\.
Il <segnaposto Server> è il nome host o il nome di dominio completo del server Exchange, ad esempio mailbox01 o mailbox01.contoso.com. Se si omette il <qualificatore Server> , il server locale è implicito.
Il < segnaposto Coda> accetta uno dei valori seguenti:
Nome coda persistente: le code persistenti hanno nomi univoci e coerenti in tutti i server Cassette postali o Trasporto Edge. Di seguito i nomi delle code persistenti:
- Invio: questa coda contiene i messaggi in attesa di essere elaborati dal classificatore.
- Non raggiungibile: questa coda contiene messaggi che non possono essere indirizzati. Questa coda non esiste fino a quando i messaggi vengono inseriti in essa.
- Non elaborabile: questa coda contiene messaggi che sono determinati come dannosi per il server Exchange. Questa coda non esiste fino a quando i messaggi vengono inseriti in essa.
Nome coda recapito: il nome di una coda di recapito è il valore della proprietà NextHopDomain della coda. Ad esempio, il nome della coda potrebbe essere lo spazio degli indirizzi di un connettore di invio, il nome di un sito di Active Directory oppure il nome di un DAG. Per ulteriori informazioni, vedere la sezione "NextHopSolutionKey" nell'argomento Code.
Numero intero coda: alle code di recapito e alle code shadow viene assegnato un valore intero univoco nel database della coda. Tuttavia, è necessario eseguire il cmdlet Get-Queue al fine di trovare il valore intero per la coda nelle proprietà Identity o QueueIdentity.
Nome coda shadow: una coda shadow usa la sintassi
Shadow\<QueueInteger>
La tabella seguente riepiloga la sintassi che è possibile usare con il parametro Identity nei cmdlet di gestione delle code. In tutti i valori, <Server> è il nome host o il nome di dominio completo del server.
Formati di identità della coda
| Valore del parametro di identità | Descrizione |
|---|---|
<Server>\<PersistentQueueName> o <PersistentQueueName> |
Una coda persistente sul server specificato o il server locale. <PersistentQueueName> è Submission, Unreachableo Poison. |
<Server>\<NextHopDomain> o <NextHopDomain> |
Una coda di recapito sul server specificato o il server locale. <NextHopDomain> è una destinazione di routing o un gruppo di recapito per i messaggi nella coda. Per ulteriori informazioni, vedere la sezione "NextHopSolutionKey" nell'argomento Code. |
<Server>\<QueueInteger> o <QueueInteger> |
Una coda di recapito sul server specificato o il server locale. <QueueInteger> è il valore intero univoco della coda visualizzato nella proprietà Identity del cmdlet Get-Queue . |
<Server>\Shadow\<QueueInteger> o Shadow\<QueueInteger> |
Una coda ombra sul server specificato o il server locale. |
<Server>\* o * |
Tutte le code sul server specificato o il server locale. È possibile utilizzare questi valori con il cmdlet Get-Queue. |
Parametro del filtro coda
È possibile utilizzare il parametro Filter in tutti i cmdlet di gestione delle code per specificare le code che si intende visualizzare o gestire sulla base delle proprietà delle code. Il parametro Filter crea un'espressione con operatori di confronto che limita l'operazione di coda alle code che soddisfano i criteri di filtro. È possibile usare l'operatore -and logico per specificare più condizioni che i risultati devono corrispondere.
Per un elenco completo delle proprietà della coda che è possibile usare con il parametro Filter , vedere Code.
Per un elenco degli operatori di confronto che è possibile usare con il parametro Filter , vedere la sezione Operatori di confronto da usare per filtrare code o messaggi in questo argomento.
Per esempi di procedure che usano il parametro Filter per visualizzare e gestire le code, vedere Gestire le code.
Includere e escludere i parametri
In Exchange 2013 sono disponibili i parametri Includi ed Escludi nel Get-Queue cmdlet . È possibile usare questi parametri singolarmente, insieme e con il parametro Filter per ottimizzare i risultati della coda nel server di trasporto locale o specificato. Ad esempio, è possibile:
- Escludere code vuote dai risultati.
- Escludere code per destinazioni esterne dai risultati.
- Includere nei risultati le code che hanno un valore specifico di DeliveryType.
I parametri Include ed Exclude usano le proprietà della coda seguenti per filtrare le code:
| Valore | Descrizione | Esempio di codice Shell |
|---|---|---|
DeliveryType |
Questo valore include o esclude le code in base alla proprietà DeliveryType. È possibile specificare più valori separati da virgole. I valori validi per DeliveryType sono illustrati nella sezione "NextHopSolutionKey" nell'argomento Code. | In questo esempio vengono restituite tutte le code di recapito sul server locale dove l'hop successivo è un connettore di invio sul server locale configurato per il routing SmartHost:Get-Queue -Include SmartHostConnectorDelivery |
Empty |
Questo valore include o esclude le code vuote. Le code vuote hanno il valore 0 nella proprietà MessageCount . |
In questo esempio vengono restituite tutte le code sul server locale che contiene i messaggiGet-Queue -Exclude Empty |
External |
Questo valore include o esclude le code con il valore External nella proprietà NextHopCategory . Le code esterni hanno sempre uno dei seguenti valori per DeliveryType:
Per ulteriori informazioni, vedere la sezione "NextHopSolutionKey" nell'argomento Code. |
In questo esempio vengono restituite tutte le code interne sul server locale.Get-Queue -Exclude External |
Internal |
Questo valore include o esclude le code con il valore Internal nella proprietà NextHopCategory . Per ulteriori informazioni, vedere la sezione "NextHopSolutionKey" nell'argomento Code. |
In questo esempio vengono restituite tutte le code interne sul server locale. Get-Queue -Include Internal |
Si noti che è possibile duplicare la funzionalità dei parametri Include ed Exclude usando il parametro Filter . Ad esempio, il comando Get-Queue -Exclude Empty restituisce lo stesso risultato di Get-Queue -Filter "MessageCount -gt 0". Tuttavia, la sintassi dei parametri Include ed Exclude è più semplice e facile da ricordare.
Get-QueueDigest
Exchange 2013 aggiunge un nuovo cmdlet della coda denominato Get-QueueDigest. Questo cmdlet consente di visualizzare informazioni su alcune o tutte le code nell'organizzazione di Exchange utilizzando un unico comando. In particolare, il cmdlet Get-QueueDigest consente di visualizzare le informazioni sulle code in base alla loro percorso sui server, nel DAG, nei siti di Active Directory o in tutta la foresta di Active Directory. Considerare che le code su un server Trasporto Edge sottoscritto nella rete perimetrale non sono inclusi nei risultati. Inoltre, Get-QueueDigest è disponibile su server Trasporto Edge ma i risultati sono limitati alle code sul server Trasporto Edge.
Nota
Per impostazione predefinita, il cmdlet Get-QueueDigest visualizza le code di recapito che contengono dieci o più messaggi e i risultati hanno una durata compresa tra uno e due minuti. Per istruzioni su come modificare questi valori predefiniti, vedere Configurare Get-QueueDigest.
I parametri di filtro e ordinamento disponibili col cmdlet Set-ContentFilterConfig vengono descritti nella tabella seguente.
| Parametro | Descrizione |
|---|---|
| Dag, Server o Site | Questi parametri si escludono a vicenda e impostano l'ambito per il cmdlet. È necessario specificare uno di questi parametri o il Forest opzionale. In genere, si utilizza il nome del server, DAG o di un sito di Active Directory, ma è possibile utilizzare qualsiasi valore che identifica in modo univoco il server, un DAG o un sito. È possibile specificare diversi server, DAG o siti separandoli con le virgole. |
| Foresta | Questa opzione è necessaria se non si utilizza Dag, Server o i parametri Site. Non è necessario specificare un valore per questa opzione. Usando questa opzione, si ottengono code da tutti i server Cassette postali di Exchange 2013 nella foresta Active Directory. Non è possibile utilizzare il parametro Forest opzionale per visualizzare le code nelle foreste remote di Active Directory. |
| DetailsLevel | Questo parametro accetta i valori None, Normale Verbose. Il valore predefinito è Normal. Quando si usa il valore None, il nome della coda viene omesso dalla colonna Dettagli nei risultati. |
| Filter | Questo parametro consente di filtrare le code in base alle proprietà della coda. È possibile usare una qualsiasi delle proprietà della coda filtrabili come descritto nell'argomento Filtri coda . |
| Groupby | Questo parametro raggruppa i risultati della coda. È possibile raggruppare i risultati in base a una delle seguenti proprietà:
Per impostazione predefinita, i risultati sono raggruppati per |
| Resultsize | Questo parametro limita i risultati delle code al valore specificato. Le code sono disposte in ordine decrescente in base al numero di messaggi nella coda e raggruppate in base al valore specificato dal parametroGroupBy. Il valore predefinito è 1000. Ciò significa che, per impostazione predefinita, il comando visualizza le prime 1000 code raggruppate per NextHopDomain e ordinate in base alle code che contengono più messaggi e alle code che ne contengono in minor quantità. |
| Timeout | Il parametro specifica il numero di secondi prima del timeout dell'operazione. Il valore predefinito è 00:00:10 o 10 secondi. |
In questo esempio vengono restituite tutte le code esterni non vuote sui server Exchange 2013 Cassette postali denominati Mailbox01,Mailbox02 e Mailbox03.
Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty
Parametri di filtro messaggi
Nella tabella seguente vengono descritti i parametri di filtro disponibili sui cmdlet di gestione dei messaggi.
| Cmdlet | Parametri di filtro | Commenti |
|---|---|---|
| Get-Message |
Identità Filter Coda |
Tutti i parametri di filtro si escludono a vicenda e è possibile utilizzarli insieme nello stesso comando. |
|
Remove-Message Resume-Message Suspend-Message |
Identità Filter |
È necessario utilizzare il parametro Identity o Filter, sebbene non sia possibile farlo nello stesso comando. |
| Export-Message | Identità | Il parametro Identity è obbligatorio. |
Si noti che un parametro Server è disponibile in tutti i cmdlet di gestione dei messaggi, ad eccezione del cmdlet Export-Message . Usare il parametro Server per connettersi a un server specifico ed eseguire i comandi di gestione dei messaggi in tale server. È possibile usare il parametro Server con o senza il parametro Filter , ma non è possibile usare il parametro Server con il parametro Identity . Usare il nome host o il nome di dominio completo del server di trasporto con il parametro Server .
Identità del messaggio
Il parametro Identity sui cmdlet di gestione dei messaggi identifica uno specifico messaggio in una o più code. Quando si usa il parametro Identity , non è possibile specificare altri parametri di filtro dei messaggi, perché il messaggio è già stato identificato in modo univoco. Il parametro Identity usa la sintassi <di base Messaggio>\<coda>\<serverInteger>.
Il <segnaposto Server> è il nome host o il nome di dominio completo del server Exchange, ad esempio mailbox01 o mailbox01.contoso.com. Se si omette il <qualificatore Server> , il server locale è implicito.
Il < segnaposto coda> accetta l'identità della coda come descritto nella sezione "Identità coda" in questo argomento. Ad esempio, è possibile utilizzare il nome della coda persistente, il valore NextHopDomain o il valore intero univoco della coda nel database delle code.
Il <segnaposto MessageInteger> rappresenta il valore intero univoco assegnato al messaggio quando entra per la prima volta nel database della coda nel server. Se il messaggio viene inviato a più destinatari che richiedono più code, tutte le copie del messaggio in tutte le code nel database della coda hanno lo stesso numero intero. Tuttavia, è necessario eseguire il cmdlet Get-Message per trovare il numero intero per il messaggio nelle proprietà Identity o MessageIdentity.
La tabella seguente riepiloga la sintassi che è possibile usare con il parametro Identity nei cmdlet di gestione dei messaggi. In tutti i valori, <Server> è il nome host o il nome di dominio completo del server.
Formati di identità del messaggio
| Valore del parametro di identità | Descrizione |
|---|---|
<Server>\<Queue>\<MessageInteger> o <Queue>\<MessageInteger> |
Un messaggio in una coda specifica sul server specificato o il server locale. <MessageInteger> è il valore intero univoco del messaggio visualizzato nella proprietà Identity del cmdlet Get-Message . <Queue> rappresenta uno dei valori seguenti:
|
<Server>\*\<MessageInteger>o o *\<MessageInteger><MessageInteger> |
Tutte le copie del messaggio in tutte le code del database della coda sul server specificato o il server locale. |
Parametro di filtro messaggi
È possibile utilizzare il parametro Filter sui cmdlet Get-Message, Remove-Message, Resume-Message e Suspend-Message per specificare i messaggi che si intendono visualizzare o gestire in base alle proprietà dei messaggi. Il parametro Filter crea un'espressione con operatori di confronto che limita l'operazione del messaggio ai messaggi che soddisfano i criteri di filtro. È possibile usare l'operatore -and logico per specificare più condizioni che i risultati devono corrispondere.
Per un elenco completo delle proprietà dei messaggi che è possibile usare con il parametro Filter , vedere Code.
Per un elenco degli operatori di confronto che è possibile usare con il parametro Filter , vedere la sezione Operatori di confronto da usare per filtrare code o messaggi in questo argomento.
Per esempi di procedure che usano il parametro Filter per visualizzare e gestire i messaggi, vedere Gestire le code.
Parametro di coda
Il parametro Queue viene usato solo con il cmdlet Get-Message . È possibile usare questo parametro per ottenere tutti i messaggi in una coda specifica o tutti i messaggi da più code usando il carattere jolly (*). Quando si usa il parametro Queue, usare il formato<>\<di identità della coda Coda> server, come descritto nella sezione "Identità coda" in questo argomento.
Gli operatori di confronto da utilizzare durante le operazioni di filtro code o messaggi
Quando si crea una coda o un'espressione del filtro messaggi utilizzando il parametro Filter, è necessario includere un operatore di confronto per il valore della proprietà in modo che corrisponda. Nella seguente tabella vengono riportati gli operatori di confronto che è possibile utilizzare in un'espressione del filtro e il funzionamento di ciascun operatore. Per tutti gli operatori i valori confrontati non fanno distinzione tra maiuscole e minuscole.
Operatori di confronto
| Operatore | Funzione | Esempio di codice Shell |
|---|---|---|
-eq |
Questo operatore viene utilizzato per specificare che i risultati devono corrispondere esattamente al valore della proprietà fornito nell'espressione. | Per visualizzare un elenco di tutte le code il cui stato è Riprova:Get-Queue -Filter "Status -eq 'Retry'" Per visualizzare un elenco di tutti i messaggi il cui stato è Riprova: Get-Message -Filter "Status -eq 'Retry'" |
-ne |
Questo operatore viene utilizzato per specificare che i risultati non devono corrispondere al valore della proprietà fornito nell'espressione. | Per visualizzare un elenco di tutte le code il cui stato non è Attivo:Get-Queue -Filter "Status -ne 'Active'" Per visualizzare un elenco di tutti i messaggi il cui stato non è Attivo: Get-Message -Filter "Status -ne 'Active'" |
-gt |
Questo operatore viene utilizzato con le proprietà in cui il valore viene espresso come numero intero o come data e ora. I risultati del filtro includono esclusivamente i messaggi o le code dove il valore della proprietà specificata è maggiore del valore fornito nell'espressione. | Per visualizzare un elenco delle code che contengono più di 1.000 messaggi:Get-Queue -Filter "MessageCount -gt 1000" Per visualizzare un elenco di messaggi il cui numero di tentativi è attualmente maggiore di 3: Get-Message -Filter "RetryCount -gt 3" |
-ge |
Questo operatore viene utilizzato con le proprietà in cui il valore viene espresso come numero intero o come data e ora. I risultati del filtro includono esclusivamente i messaggi e le code dove il valore della proprietà specificata è maggiore o uguale al valore fornito nell'espressione. | Per visualizzare un elenco delle code che contengono 1.000 o più messaggi:Get-Queue -Filter "MessageCount -ge 1000" Per visualizzare un elenco di messaggi il cui numero di tentativi è attualmente uguale o maggiore di 3: Get-Message -Filter "RetryCount -ge 3" |
-lt |
Questo operatore viene utilizzato con proprietà dove il valore viene espresso come numero intero o come data e ora. I risultati del filtro includono esclusivamente i messaggi e le code nelle quali il valore della proprietà specificata è minore del valore fornito nell'espressione. | Per visualizzare un elenco delle code che contengono meno di 1.000 messaggi:Get-Queue -Filter "MessageCount -lt 1000" Per visualizzare un elenco di messaggi il cui valore SCL è inferiore a 6: Get-Message -Filter "SCL -lt 6" |
-le |
Questo operatore viene utilizzato con proprietà dove il valore viene espresso come numero intero o come data e ora. I risultati del filtro includono esclusivamente i messaggi e le code nelle quali il valore della proprietà specificata è minore o uguale al valore fornito nell'espressione. | Per visualizzare un elenco delle code che contengono 1.000 o meno messaggi:Get-Queue -Filter "MessageCount -le 1000" Per visualizzare un elenco di messaggi il cui valore SCL è minore o uguale a 6: Get-Message -Filter "SCL -le 6" |
-like |
Questo operatore viene utilizzato con le proprietà in cui il valore viene espresso come stringa di testo. I risultati del filtro includono esclusivamente i messaggi e le code nelle quali il valore della proprietà specificata contiene una stringa di testo fornita nell'espressione. È possibile includere il carattere jolly (*) in un'espressione -like applicata a un campo stringa di testo, ma non a un campo di tipo enumerazione. | Per visualizzare un elenco delle code di recapito con destinazioni all'interno di un qualsiasi dominio SMTP che termina con Contoso.com:Get-Queue -Filter "Identity -like '*contoso.com'" Per visualizzare un elenco di messaggi il cui oggetto contiene il testo "payday loan": Get-Messages -Filter "Subject -like '*payday loan*'" |
È possibile specificare un filtro che valuti più espressioni utilizzando l'operatore di confronto -and. Per essere inclusi nei risultati, è necessario che le code e i messaggi soddisfino tutte le condizioni del filtro.
In questo esempio viene visualizzato un elenco di code con destinazioni all'interno di un qualsiasi nome di dominio SMTP che termina con Contoso.com e che contiene più di 500 messaggi.
Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"
In questo esempio viene visualizzato un elenco di messaggi inviati da un qualsiasi indirizzo di posta elettronica del dominio contoso.com il cui valore SCL è maggiore di 5.
Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"
Parametri di paging avanzati
In base al flusso di posta corrente, le query relative a code e messaggi possono restituire un insieme di oggetti di notevoli dimensioni. È possibile utilizzare i parametri di paging avanzati per controllare come verranno recuperati e visualizzati i risultati delle query.
Quando si utilizza Shell per visualizzare le code e i relativi messaggi, viene recuperata una pagina di informazioni alla volta. I parametri di paging avanzati consentono di controllare la dimensione dell'insieme di risultati, ma anche di ordinarli. Tutti i parametri di paging avanzati sono facoltativi e possono essere combinati con qualsiasi insieme di parametri utilizzabile con i cmdlet Get-Queue e Get-Message. Se non viene specificato alcun parametro di paging avanzato, la query restituisce i risultati in ordine crescente in base all'identità.
Per impostazione predefinita, quando si specifica un ordinamento, la proprietà relativa all'identità del messaggio viene sempre inclusa e ordinata in ordine crescente. Questa è la relazione di ordinamento predefinita. Viene inclusa la proprietà dell'identità del messaggio poiché le altre proprietà che possono essere incluse in un ordinamento non sono univoche. Includendo esplicitamente nell'ordinamento la proprietà relativa all'identità del messaggio, è possibile specificare che nei risultati l'identità del messaggio venga ordinata in ordine decrescente.
È possibile usare i parametri BookmarkIndex e BookmarkObject per contrassegnare una posizione nel set di risultati ordinato. Se l'oggetto segnalibro non esiste più quando viene recuperata la pagina successiva di risultati, la relazione di ordinamento predefinita garantisce che l'insieme di risultati inizi dall'oggetto più vicino al segnalibro. L'oggetto più vicino dipende dall'ordinamento specificato.
Nella tabella seguente vengono descritti i parametri di paging avanzati.
| Parametro | Descrizione |
|---|---|
| BookmarkIndex | Il parametro consente di specificare la posizione nell'insieme di risultati da cui iniziano i risultati visualizzati. Il valore del parametro è un indice in base 1 nell'insieme dei risultati totale. Se il valore è inferiore o uguale a zero, verrà restituita la prima pagina completa dei risultati. Se il valore è impostato su Int.MaxValue, viene restituita l'ultima pagina completa dei risultati. |
| BookmarkObject | Il parametro consente di specificare l'oggetto nell'insieme di risultati da cui iniziano i risultati visualizzati. Una volta specificato, l'oggetto segnalibro viene utilizzato come punto per iniziare la ricerca. Verranno recuperate le righe precedenti o successive all'oggetto, in base al valore del parametro SearchForward. Non è possibile combinare il parametro BookmarkObject e il parametro BookmarkIndex in una singola query. |
| IncludeBookmark | Il parametro consente di specificare se includere l'oggetto segnalibro nell'insieme di risultati. Per impostazione predefinita, il valore è impostato su $true e l'oggetto bookmark è incluso. È possibile eseguire una query relativa a una dimensione dei risultati limitata e specificare l'ultimo elemento nell'insieme di risultati come segnalibro per la query successiva. In questo caso, è possibile impostare IncludeBookmark$false su in modo che l'oggetto non sia incluso in entrambi i set di risultati. |
| Resultsize | Il parametro consente di specificare il numero di risultati da visualizzare per pagina. Se non si specifica un valore, viene utilizzato il numero di risultati predefinito di 1000 oggetti. L'insieme di risultati di Exchange è limitato a 250.000 oggetti. |
| ReturnPageInfo | È un parametro nascosto. che restituisce informazioni sul numero totale di risultati e sull'indice del primo oggetto della pagina corrente. Il valore predefinito è $false. |
| SearchForward | Il parametro consente di specificare se cercare in avanti o all'indietro nell'insieme di risultati. Questo parametro non influisce sull'ordine in cui viene restituito l'insieme di risultati. Consente di determinare la direzione della ricerca in relazione all'oggetto o all'indice del segnalibro. Se questi non vengono specificati, il parametro SearchForward consente di determinare se la ricerca inizia dal primo o dall'ultimo oggetto nell'insieme di risultati. Il valore predefinito per questo parametro è $true. Se il parametro è impostato su $true e viene specificato un segnalibro, la query esegue la ricerca da tale segnalibro. Se si utilizza questa configurazione e non è presente alcun risultato oltre il segnalibro, la query restituisce l'ultima pagina completa di risultati. Se il parametro SearchForward è impostato su $false e viene specificato un segnalibro, la query esegue una ricerca all'indietro da tale segnalibro. Se si utilizza questa configurazione ed è presente meno di una pagina completa di risultati oltre il segnalibro, la query restituisce la prima pagina completa di risultati. |
| Sortorder | Il parametro consente di specificare una matrice di proprietà dei messaggi utilizzate per controllare l'ordinamento dell'insieme di risultati. Le proprietà dell'ordinamento sono specificate in ordine decrescente in base alla priorità. Ogni proprietà è separata da una virgola e presenta il simbolo del segno più (+) per l'ordine crescente oppure il simbolo del segno meno (-) per l'ordine decrescente. Se non viene specificato un ordinamento in modo esplicito tramite questo parametro, i record che soddisfano la query vengono visualizzati e ordinati in base al campo Identità del relativo tipo di oggetto. Quando l'ordinamento non viene specificato in modo esplicito, i risultati vengono sempre ordinati in base all'identità in ordine crescente. |
Nel seguente esempio di codice viene illustrato come utilizzare i parametri di paging avanzati in una query. In questo esempio, il comando esegue la connessione al server specificato e recupera un insieme di risultati contenente 500 oggetti. I risultati vengono visualizzati in base a un ordinamento, prima in ordine crescente per indirizzo del mittente, quindi in ordine decrescente per dimensione del messaggio:
Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
Per visualizzare le pagine successive, è possibile impostare un segnalibro per l'ultimo oggetto recuperato in un insieme di risultati ed eseguire un'ulteriore query. Per completare la procedura, è necessario utilizzare le funzionalità di scripting di Shell.
Nell'esempio riportato di seguito viene utilizzato lo scripting per recuperare la prima pagina di risultati, impostare l'oggetto segnalibro, escludere l'oggetto segnalibro dall'insieme di risultati e recuperare i 500 oggetti successivi sul server specificato.
Aprire Shell e digitare il seguente comando per recuperare la prima pagina di risultati:
$Results=Get-message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-SizePer impostare l'oggetto segnalibro, digitare il seguente comando per salvare l'ultimo elemento della prima pagina in una variabile:
$temp=$results[$results.length-1]Per recuperare i 500 oggetti successivi sul server specificato e per escludere l'oggetto segnalibro, digitare il seguente comando:
Get-message -Server mailbox01.contoso.com -BookmarkObject:$temp -IncludeBookmark $False -ResultSize 500 -SortOrder +FromAddress,-Size