Get-EXOMailboxFolderPermission
此 cmdlet 仅在 Exchange Online PowerShell 模块中可用。 有关详细信息，请参阅关于 Exchange Online PowerShell 模块。
使用 Get-ExOMailboxFolderPermission cmdlet 查看邮箱中的文件夹级权限。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
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
ExternalDirectoryObjectId 参数标识要通过 Azure Active Directory 中的 ObjectId 查看的邮箱。
不能将此参数与 Identity、PrimarySmtpAddress 或 UserPrincipalName 参数一起使用。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupMailbox
需要 GroupMailbox 开关才能在结果中返回Microsoft 365 组。 不必为此开关指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Identity 参数指定要查看的邮箱文件夹。 此参数使用语法： <Mailbox>:\<Folder>。 为了获得最佳性能，我们建议使用用户 ID 或用户主体名称 (UPN) 来标识邮箱。
否则，可以使用唯一标识邮箱的任何值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- LegacyExchangeDN
- SamAccountName
不能将此参数与 ExternalDirectoryObjectId、PrimarySmtpAddress 或 UserPrincipalName 参数一起使用。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PrimarySmtpAddress
PrimarySmtpAddress 按主 SMTP 电子邮件地址 (标识要查看的邮箱， navin@contoso.com 例如，) 。
不能将此参数与 ExternalDirectoryObjectId、Identity 或 UserPrincipalName 参数一起使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-User
User 参数按指定邮箱、邮件用户或启用邮件的安全组筛选结果， (授予邮箱文件夹权限的安全主体) 。 可以使用任何能够唯一标识该用户或组的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
注意：如果指定的用户无权访问邮箱文件夹，该命令将引发异常。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserPrincipalName
UserPrincipalName 参数标识要由 UPN (查看的邮箱， navin@contoso.onmicrosoft.com 例如，) 。
不能将此参数与 ExternalDirectoryObjectId、Identity 或 PrimarySmtpAddress 参数一起使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |