Get-EXOMailboxFolderPermission

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Online

此 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