Get-PublicFolder

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

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

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-Recurse]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Get-PublicFolder
   [-LostAndFound]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-PublicFolder

本範例使用不含參數的 Get-PublicFolder 命令來傳回根公用資料夾物件 (IPM_SUBTREE)。

範例 2

Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name

本範例傳回所有系統資料夾的名稱 (這些名稱預設不顯示)，從系統資料夾根目錄開始 (\NON_IPM_SUBTREE)。

範例 3

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"

本範例從 \Legal\Documents\ 傳回 Pending Litigation 公用資料夾。

範例 4

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse

本範例會傳回 \Legal\Documents\ 的 Pending Litigation 公用資料夾，以及 Pending Litigation 公用資料夾下的所有公用資料夾。由於未指定結果大小，因此命令最多會傳回最大數目 (即 10,000 個) 的公用資料夾。

範例 5

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited

本範例會傳回 \Legal\Documents\ 的 Pending Litigation 公用資料夾，以及 Pending Litigation 公用資料夾下的所有公用資料夾，但沒有傳回數目的限制。

範例 6

Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders

此範例會傳回 Legal Department 公用資料夾內容信箱內的公用資料夾。

參數

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GetChildren

GetChildren 參數會指定是否只傳回 Identity 參數所指定資料夾的子系。您不需要使用此參數指定值。

您無法搭配 Recurse 或 LostAndFound 參數使用此參數。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Identity 參數會指定您想要檢視之公用資料夾的名稱和路徑。有效的值會使用語法： \Level1\Level2\...\LevenN\PublicFolder 。例如，"\Customer Discussion" 或 "\Engineering\Customer Discussion"。

Type:	PublicFolderIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LostAndFound

LostAndFound 參數會指定是否只傳回位於 \NON_IPM_SUBTREE\LOST_AND_FOUND 的孤立檔案夾。您不需要使用此參數指定值。

當資料夾存在於次要公用資料夾信箱中，但不在主要資料夾中時，LOST_AND_FOUND資料夾會保留公用資料夾階層對帳程式重新建立的遺漏資料夾。

您無法搭配 Identity 參數或 Recurse 或 LostAndFound 參數使用此參數。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

Mailbox 參數會指定階層公用資料夾的識別碼。您可以使用可唯一識別信箱的任何值。例如：

名稱
別名
辨別名稱 (DN)
辨別名稱 (DN)
Domain\Username
電子郵件地址
GUID
LegacyExchangeDN
SamAccountName
使用者識別碼或使用者主要名稱 (UPN)

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Organization

此參數僅適用於內部部署 Exchange。

將保留此參數供 Microsoft 內部使用。

Type:	OrganizationIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Recurse

Recurse 參數會指定是否要傳回指定的公用資料夾及其所有子系。您不需要使用此參數指定值。

您無法搭配 GetChildren 或 LostAndFound 參數使用此參數。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResidentFolders

ResidentFolders 參數會指定是否要傳回位於特定內容公用資料夾信箱中的公用資料夾。您不需要使用此參數指定值。

如果您未使用此參數，命令只會傳回內容位於主要階層公用資料夾信箱中的公用資料夾。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

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

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Server

此參數僅適用于 2010 Exchange Server。

Server 參數會依指定的 Exchange Server 篩選結果。您可以使用唯一識別伺服器的任何值。例如：

Name
FQDN
辨別名稱 (DN)
Exchange Legacy DN

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。