Get-EXOMailboxFolderPermission
此 cmdlet 仅在 Exchange Online PowerShell 模块中可用。 有关详细信息，请参阅关于 Exchange Online PowerShell 模块。
使用 Get-ExOMailboxFolderPermission cmdlet 查看邮箱中的文件夹级权限。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
Get-EXOMailboxFolderPermission
[[-Identity] <String>]
[-ExternalDirectoryObjectId <Guid>]
[-GroupMailbox]
[-PrimarySmtpAddress <String>]
[-User <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
说明
使用此 cmdlet 检索邮箱中的文件夹级别权限。
示例
示例 1
Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports
本示例返回 John 邮箱中 Marketing 文件夹下 Reports 子文件夹的用户权限的当前列表。
示例 2
Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports -User Kim@contoso.com
此示例返回 John 邮箱中同一文件夹的权限，但仅返回用户 Kim 的权限。
参数
-ExternalDirectoryObjectId
适用：Exchange Online
ExternalDirectoryObjectId 参数标识要通过 Microsoft Entra ID 中的 ObjectId 查看的邮箱。
不能将此参数与 Identity、PrimarySmtpAddress 或 UserPrincipalName 参数一起使用。
参数属性
| 类型: | Guid |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-GroupMailbox
适用：Exchange Online
需要 GroupMailbox 开关才能返回结果中的Microsoft 365 组。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：Exchange Online
Identity 参数指定要查看的邮箱文件夹。 此参数使用语法 <Mailbox>:\<Folder>。 为了获得最佳性能，我们建议使用用户 ID 或用户主体名称 (UPN) 来标识邮箱。
否则，可以使用唯一标识邮箱的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- LegacyExchangeDN
- SamAccountName
不能将此参数与 ExternalDirectoryObjectId、PrimarySmtpAddress 或 UserPrincipalName 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-PrimarySmtpAddress
适用：Exchange Online
PrimarySmtpAddress 按主 SMTP 电子邮件地址 (标识要查看的邮箱， navin@contoso.com 例如，) 。
不能将此参数与 ExternalDirectoryObjectId、Identity 或 UserPrincipalName 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-User
适用：Exchange Online
User 参数按指定邮箱、邮件用户或启用邮件的安全组筛选结果， (授予邮箱文件夹权限的安全主体) 。 可以使用任何能够唯一标识该用户或组的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
注意：如果指定的用户无权访问邮箱文件夹，该命令将返回错误。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UserPrincipalName
适用：Exchange Online
UserPrincipalName 参数标识要由 UPN (查看的邮箱， navin@contoso.onmicrosoft.com 例如，) 。
不能将此参数与 ExternalDirectoryObjectId、Identity 或 PrimarySmtpAddress 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。