Get-PublicFolder
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Get-PublicFolder 指令程式來擷取公用資料夾或一組公用資料夾的屬性。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
GetChildren
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-GetChildren]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
Recurse
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-Recurse]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
LostAndFound
Get-PublicFolder
[-LostAndFound]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Identity
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-Server <ServerIdParameter>]
[<CommonParameters>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 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 Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GetChildren
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
GetChildren 參數會指定是否只傳回 Identity 參數所指定資料夾的子系。 您不需要使用此參數指定值。
您無法將此參數與 Recurse 或 LostAndFound 參數搭配使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetChildren
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 參數會指定您要檢視之公用資料夾的名稱和路徑。 有效的值使用語法： \Level1\Level2\...\LevenN\PublicFolder。 例如，"\Customer Discussion" 或 "\Engineering\Customer Discussion"。
警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。
參數屬性
| 類型: | PublicFolderIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetChildren
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
Recurse
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
Identity
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-LostAndFound
適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
LostAndFound 參數會指定是否只傳回位於 \NON_IPM_SUBTREE\LOST_AND_FOUND 中的孤立資料夾。 您不需要使用此參數指定值。
LOST_AND_FOUND資料夾會包含遺失的資料夾，當資料夾存在於次要公用資料夾信箱中，而不在主要公用資料夾信箱中時，公用資料夾階層核對程序會重新建立這些資料夾。
您無法將此參數與 Identity 參數或 Recurse 或 LostAndFound 參數搭配使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
LostAndFound
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Mailbox
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Mailbox 參數會指定階層公用資料夾的識別碼。 您可以使用可唯一識別信箱的任何值。 例如：
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 網域\使用者名稱
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
參數屬性
| 類型: | MailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Organization
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | OrganizationIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Recurse
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Recurse 參數會指定是否要傳回指定的公用資料夾及其所有子資料夾。 您不需要使用此參數指定值。
您無法將此參數與 GetChildren 或 LostAndFound 參數搭配使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Recurse
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResidentFolders
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ResidentFolders 參數可指定是否傳回位於特定內容公用資料夾信箱中的公用資料夾。 您不需要使用此參數指定值。
如果未使用此參數，此命令只會傳回內容位於主要階層公用資料夾信箱中的公用資料夾。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResultSize
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ResultSize 參數會指定傳回的結果筆數上限。 預設最大值為 10,000。 若要使傳回結果沒有限制，請將此參數設為 Unlimited。 此參數只能與 Recurse 或 GetChildren 參數一起傳送。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetChildren
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Recurse
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
LostAndFound
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用：Exchange Server 2010
Server 參數會依指定的 Exchange 伺服器篩選結果。 您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- Exchange Legacy DN
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetChildren
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
Recurse
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。