Get-PublicFolder
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Get-PublicFolder cmdlet 可检索一个公用文件夹或一组公用文件夹的属性。
有关以下语法部分的参数设置的详细信息，请参阅 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>]
说明
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 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"。
参数属性
| 类型: | 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
- 用户 ID 或用户主体名称 (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
此参数仅在 Exchange Server 2010 中可用。
Server 参数按指定的 Exchange 服务器筛选结果。 可以使用唯一标识该服务器的任何值。 例如：
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 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
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。