Get-Message (RTM)

  • 發行項

 

適用版本： Exchange Server 2007 SP1, Exchange Server 2007

上次修改主題的時間： 2007-08-06

使用 Get-Message 指令程式，可以在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上，檢視佇列中一或多封郵件的詳細資料。

語法

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[]>]

詳細描述

Get-Message 指令程式顯示 Hub Transport Server 或 Edge Transport Server 上現有佇列之一或多封郵件的詳細資料。如果不提供參數，則命令會查詢本機伺服器上任何佇列中的所有郵件，並傳回一頁結果。預設的頁面大小是 1,000 個物件。將伺服器名稱包含為 Identity 參數或 Queue 參數的一部分，或包含 Server 參數，就可以顯示遠端伺服器上的郵件。Identity 參數、Queue 參數及 Filter 參數集互斥。

若要執行 Get-Message 指令程式，必須對您使用的帳戶委派 Exchange Server 系統管理員角色。

若要在已安裝 Edge Transport server role 的電腦上執行 Get-Message 指令程式，則必須使用該電腦之本機 Administrators 群組成員的帳戶進行登入。

如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

BookmarkIndex

選用

System.Int32

使用 BookmarkIndex 參數可以指定所顯示結果在結果集中的開始位置。此參數的值是總結果集中以 1 為基礎的索引。BookmarkIndex 不可與 BookmarkObject 參數搭配使用。

BookmarkObject

選用

Microsoft.Exchange.Data.QueueViewer.MessageInfo

使用 BookmarkObject 參數可以指定所顯示結果在結果集中的開始物件。BookmarkObject 不可與 BookmarkIndex 參數搭配使用。

Filter

選用

System.String

Filter 參數需要運算式，在其中指定您要顯示之郵件的內容值準則。運算式包含內容名稱，名稱後面接著比較運算子和值。下列訊息內容是可用於 Filter 參數的有效準則：

  • DateReceived   收到訊息的日期。
  • ExpirationTime   訊息過期的時間。
  • FromAddress   訊息寄件者的簡易郵件傳送通訊協定 (SMTP) 地址。該值是從郵件信封的 MAIL FROM: 中擷取。
  • Identity   代表特定訊息及選用伺服器和佇列識別的整數。
  • InternetMessageId   Message-ID: 標頭欄位的值。此內容的表示方式是 GUID 後面接著傳送伺服器的 SMTP 位址，如下面範例所示：67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com。
  • LastError   文字字串，記錄訊息上次的錯誤。
  • MessageSourceName   將此訊息提交到佇列之元件名稱的文字字串。
  • Queue   指定保留訊息之佇列的識別。請以 Server\destination 的形式輸入佇列識別，其中 destination 是遠端網域、信箱伺服器或持續佇列名稱。
  • RetryCount   將訊息傳遞至目的地的嘗試次數。
  • SCL   SCL 內容指定郵件的垃圾郵件信賴等級。有效 SCL 項目是整數 0 到 9。空白的 SCL 屬性值指出內容篩選器代理程式尚未處理郵件。
  • Size   訊息的大小。
  • SourceIP   將訊息提交到 Exchange 組織的外部伺服器之 IP 位址。
  • Status   目前的訊息狀態。訊息狀態選項有 Active、Retry、Suspended、PendingSuspend 或 PendingRemove。
  • Subject   代表電子郵件主旨的文字字串。該值是從 Subject: 標頭欄位擷取。

您可以使用 - and 比較運算子來指定多個篩選準則。不是以單一整數來表示的內容值必須用引號括住。

Identity

選用

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

使用 Identity 參數指定 MessageIdentity 整數。這是代表特定訊息的整數，伺服器及佇列識別是選用的。此參數的指定語法如下：

  • Server\QueueIdentity\MessageIdentity
  • QueueIdentity\MessageIdentity
  • Server\*\MessageIdentity
  • MessageIdentity

IncludeBookmark

選用

System.Boolean

使用 IncludeBookmark 參數可以指定是否要在顯示查詢結果時包括書籤物件。IncludeBookmark 參數在配合 BookmarkObject 或 BookmarkIndex 參數使用時為有效的參數。如果未指定 IncludeBookmark 參數的值，則會使用 $true 的預設值。

IncludeRecipientInfo

選用

System.Management.Automation.SwitchParameter

使用 IncludeRecipientInfo 參數，可以將郵件收件者顯示在 [收件者] 欄位中。如果未包括 IncludeRecipientInfo 參數，則 [收件者] 欄位會空白。

將 Get-Message -IncludeRecipientInfo 命令的結果儲存在變數中，可讓您顯示郵件收件者的其他內容。下列清單說明可用的收件者內容：

  • Address   收件者的電子郵件地址
  • Type   收件者類型可以是 External、Mailbox 或 DL。目的地是擴充伺服器時會使用 DL。
  • FinalDestination   用來路由傳送郵件之物件的辨別名稱 (DN)。物件可以是連接器、信箱伺服器或擴充伺服器。
  • Status   收件者狀態可以是 Complete、Ready 或 Retry。
  • LastError   前次傳遞嘗試後的 SMTP 回應，如果郵件是放在無法達到的佇列中，則為當地語系化的錯誤訊息。

例如，若要將 "Contoso.com" 遠端傳遞佇列中 MessageIdentity 值為 1234 之郵件的收件者資訊儲存至名為 $x 的變數中，請使用下列命令：

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

若要顯示現在儲存於 $x 變數中的擴充收件者內容，請使用下列命令：

$x.Recipients

Queue

選用

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

使用 Queue 參數可指定您要顯示之郵件所在的佇列的識別碼。請以 Server\destination 的形式輸入佇列識別，其中 destination 是遠端網域、信箱伺服器或持續佇列名稱。

ResultSize

選用

Microsoft.Exchange.Data.Unlimited

使用 ResultSize 參數可以指定要顯示在結果集中的總項目數。預設的 ResultSize 參數值是設為 1,000。ResultSize 支援沒有限制的結果數，但是 Microsoft Exchange 會將結果集限制為 250,000。

ReturnPageInfo

選用

System.Boolean

ReturnPageInfo 參數是隱藏參數。使用它以傳回有關總結果數及目前頁面之第一個物件的索引的相關資訊。預設值為 $false。

SearchForward

選用

System.Boolean

使用 SearchForward 參數可以指定要在結果集中進行往前或往後的搜尋。預設值為 $true。此值會從結果集的開頭或從所指定的書籤往前計算結果頁。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

使用 Server 參數可以指定要連接的伺服器名稱，方法是使用遠端程序呼叫 (RPC)，此遠端程序呼叫包含保留想要顯示之郵件的佇列。請以主機名稱或網域全名 (FQDN) 來輸入 Server 參數。如果未使用此參數，則會查詢本機伺服器。

SortOrder

選用

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

使用 SortOrder 參數可以指定用來控制結果集之排序順序的郵件內容的陣列。以逗號分隔每個內容。在內容名稱的開頭加上 + 號，以使用遞增順序顯示結果。在內容名稱的開頭加上 - 號，以使用遞減順序顯示結果。如果不指定排序順序，則結果集會按 MessageIdentity 整數以遞增順序顯示。

範例

下列範例顯示如何使用 Get-Message 命令查詢郵件。第一個範例顯示如何顯示本機伺服器的佇列中，接收自所指定網域之任何寄件者的所有郵件。此命令會傳送至 Format-List 命令，將結果格式化為詳細清單。

第二個範例顯示如何顯示本機伺服器的佇列中，接收自所指定網域之任何寄件者，而且 SCL 值大於 3 的所有郵件。

第三個範例則顯示如何連接至遠端伺服器，然後以指定的排序順序顯示遠端伺服器佇列上的所有郵件。結果會先以遞增順序排序，然後再按大小的遞減順序排序。

如需管線的相關資訊，請參閱管線。

如需如何處理命令輸出的相關資訊，請參閱使用命令列輸出。

如需如何使用 Exchange 管理命令介面來執行佇列檢視器工作的相關資訊，請參閱使用 Exchange 管理命令介面管理佇列。

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

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.