Get-PublicFolder

  • 發行項

 

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

上次修改主題的時間： 2009-05-12

使用 Get-PublicFolder 指令程式來擷取公用資料夾或一組公用資料夾的屬性。

語法

Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

詳細描述

若要執行 Get-PublicFolder 指令程式，您使用的帳戶必須已委派下列：

  • Exchange 公用資料夾系統管理員角色和目標伺服器的本機 Administrators 群組。

參數

參數 必要 類型 描述

GetChildren

必要

System.Management.Automation.SwitchParameter

使用 GetChildren 參數來擷取僅由 Identity 參數所指定的子系資料夾。GetChildren 參數與 Recurse 參數是互斥的。

Recurse

必要

System.Management.Automation.SwitchParameter

Recurse 參數可指定命令必須傳回指定的公用資料夾及其所有子系資料夾。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。

Identity

選用

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

使用 Identity 參數，可以指定代表特定公用資料夾的 GUID 或公用資料夾名稱。您也可以使用 TopLevelPublicFolder\PublicFolder 的格式加入路徑。

您可以略過 Identity 參數標籤，而只提供公用資料夾名稱或 GUID。

ResultSize

選用

Microsoft.Exchange.Data.Unlimited

ResultSize 參數可指定傳回的結果筆數上限。預設最大值為 10,000。若要使傳回結果沒有限制，請將此參數設定為 Unlimited。此參數只能與 Recurse 或 GetChildren 參數一起傳送。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 參數可指定執行所選取之作業的伺服器。

輸入類型

傳回類型

錯誤

錯誤 描述

 

例外狀況

例外狀況 描述

 

範例

下列程式碼範例顯示如何使用 Get-PublicFolder 命令：

  • 第一個範例使用不加參數的 Get-PublicFolder 命令來傳回根公用資料夾物件 (IPM_SUBTREE)。
  • 第二個範例傳回所有系統資料夾的名稱 (根據預設，這些名稱並不會顯示出來)，從系統資料夾根目錄開始 (\NON_IPM_SUBTREE)。
  • 第三個範例傳回具有指定之長期項目識別碼的公用資料夾。
  • 第四個範例從 \Legal\Documents\ 傳回 Pending Litigation 公用資料夾。
  • 第五個範例從 \Legal\Documents\ 傳回 Pending Litigation 公用資料夾，而且在 Pending Litigation 公用資料夾下最多可有 9,999 個公用資料夾。
  • 第六個範例從 \Legal\Documents\ 傳回 Pending Litigation 公用資料夾及其下所有的公用資料夾，但沒有傳回數目的限制。
Get-PublicFolder 
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name  
Get-PublicFolder -Identity <long-term entry identifier of a public folder>
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited

當您執行 Get-PublicFolder 指令程式，而且 UseDatabaseQuotaDefaults 值為 true 時，下列值會顯示來自 Get-PublicFolderDatabase 的資料庫值：

  • MaxItemSize
  • IssueWarningQuota
  • ProhibitPostQuota

此外，每個值都會附加 "(InheritFromDB)" 字串。

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