Get-PublicFolder (RTM)
适用于： Exchange Server 2007
上一次修改主题： 2007-06-06
使用 Get-PublicFolder cmdlet 可检索一个公用文件夹或一组公用文件夹的属性。
语法
Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
详细说明
若要运行 Get-PublicFolder cmdlet，必须为您使用的帐户委派以下角色：
- Exchange 仅查看管理员角色
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
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