Get-PublicFolder

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 Get-PublicFolder cmdlet 可检索一个公用文件夹或一组公用文件夹的属性。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

说明

您必须先获得权限，然后才能运行此 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 中可用。

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)
域\用户名
电子邮件地址
GUID
LegacyExchangeDN
SamAccountName
用户 ID 或用户主体名称 (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 服务器筛选结果。可以使用唯一标识该服务器的任何值。例如：

名称
FQDN
可分辨名称 (DN)
Exchange 旧版 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

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。