Condividi tramite


Get-Queue

 

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-Queue consente di visualizzare le informazioni sulla configurazione delle code in un computer in cui è installato il ruolo del server Trasporto Hub o Trasporto Edge.

Sintassi

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

Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Descrizione dettagliata

Il cmdlet Get-Queue consente di visualizzare le informazioni sulle code esistenti in un server Trasporto Hub o Trasporto Edge. Se non vengono forniti parametri, il comando esegue una query di tutte le code del server locale e restituisce una pagina singola di risultati. La dimensione predefinita della pagina è 1.000 oggetti. È possibile visualizzare le code in un server remoto includendo il nome server nel parametro Identity oppure utilizzando il parametro Server con una query di filtro. Le impostazioni del parametro Identity e del parametro Filter si escludono a vicenda.

Per eseguire il cmdlet Get-Queue, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo degli amministratori di Exchange Server

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.QueueInfo

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 della proprietà per le code che si desidera visualizzare L'espressione include un nome di proprietà seguito da un operatore di confronto e da un valore. Di seguito sono riportate le proprietà di coda che sono criteri validi per il parametro Filter.

  • DeliveryType   Il tipo di recapito per questa coda definito dal trasporto. Il tipo di recapito deve essere uno dei seguenti valori:

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Non definito

    • Non raggiungibile

  • Identity   Immettere l'identità della coda nel formato Server\destinazione dove destinazione è un dominio remoto, un server cassetta postale o un nome coda persistente.

  • LastError   Una stringa di testo relativa all'ultimo errore registrato per una coda.

  • LastRetryTime   L'ora dell'ultimo tentativo di connessione per la coda corrente.

  • MessageCount   Il numero di elementi presenti nella coda.

  • NextHopConnector   Il GUID del connettore utilizzato per creare la coda.

  • NextHopDomain   Il dominio hop successivo della coda, specificato come dominio SMTP (Simple Mail Transfer Protocol) remoto, nome server, nome di un sito Active Directory o identificativo del database dei messaggi (MDB).

  • NextRetryTime   L'ora del prossimo tentativo di connessione per la coda corrente.

  • Status   Lo stato della coda. Le opzioni per lo stato della coda sono Attivo, Pronto, Riprova o Sospeso.

È 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.

Identity

Facoltativo

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Utilizzare il parametro Identity per specificare l'identità della coda che contiene 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.

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.

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 nome del server come nome host oppure un nome dominio completo. Se il parametro Server 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, l'insieme dei risultati viene visualizzato in ordine ascendente in base al parametro QueueIdentity.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Esempio

Nell'esempio seguente vengono mostrati tre comandi Get-Queue. Il primo comando mostra come visualizzare le informazioni sulla configurazione per tutte le code presenti in un server Trasporto Hub o Edge Transport in cui viene eseguito il comando. Il comando viene reindirizzato al comando Format-List per formattare i risultati come un elenco dettagliato.

Il secondo comando mostra come visualizzare le informazioni sulla configurazione solo per le code che contengono più di 100 messaggi.

Il terzo comando mostra come visualizzare le informazioni sulla configurazione per una coda esistente in un server remoto.

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-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com