Get-PublicFolderClientPermission
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-PublicFolderClientPermission cmdlet 可以检索公用文件夹的用户权限。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Get-PublicFolderClientPermission
[-Identity] <PublicFolderIdParameter>
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[-User <PublicFolderUserIdParameter>]
[-Mailbox <MailboxIdParameter>]
[<CommonParameters>]
说明
若要查看公用文件夹上可用的权限,请参阅Exchange Server的公用文件夹权限。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-PublicFolderClientPermission "\My Public Folder"
本示例检索 \My Public Folder 的所有用户的权限。
示例 2
Get-PublicFolderClientPermission -Identity "\My Public Folder" -User Chris | Format-List
本示例将检索用户 Chris 对公用文件夹 My Public Folder 的权限。 在本示例中,将 Get-PublicFolderClientPermission 命令的输出通过管道传递给 Format-List 命令,以便在结果中显示所有可用信息。
参数
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
类型: | Fqdn |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定代表特定公用文件夹的 GUID 或公用文件夹名称。 还可以包含使用\顶级公用文件夹\公用文件夹格式的路径。
可以省略参数标签,以便只提供公用文件夹名称或 GUID。
类型: | PublicFolderIdParameter |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
Mailbox 参数指定要查看其权限的公用文件夹邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
默认情况下,权限从主公用文件夹邮箱返回。 使用此参数可以指定不同的公用文件夹邮箱。
类型: | MailboxIdParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
适用于: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ResultSize
此参数仅在基于云的服务中可用。
ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。
类型: | Unlimited |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
适用于: | Exchange Online |
-Server
此参数仅在 Exchange Server 2010 中可用。
Server 参数按指定的 Exchange 服务器筛选结果。 可以使用唯一标识该服务器的任何值。 例如:
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
类型: | ServerIdParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
适用于: | Exchange Server 2010 |
-User
User 参数指定要查看其公用文件夹权限的用户。
为了获得最佳结果,我们建议使用以下值:
- UPN:例如,
user@contoso.com
(用户仅) 。 - Domain\SamAccountName:例如
contoso\user
。
类型: | PublicFolderUserIdParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
适用于: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。