Get-EXOMailboxFolderPermission

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Online

此 Cmdlet 僅適用于 Exchange Online PowerShell 模組。 如需詳細資訊，請參閱關於 Exchange Online PowerShell 模組。

使用 Get-ExOMailboxFolderPermission Cmdlet 來檢視信箱中的資料夾層級許可權。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-EXOMailboxFolderPermission
   [[-Identity] <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-GroupMailbox]
   [-PrimarySmtpAddress <String>]
   [-User <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Description

使用此 Cmdlet 擷取信箱中的資料夾層級許可權。

範例

範例 1

Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports

This example returns the current list of user permissions for the Reports subfolder in the Marketing folder in John's mailbox.

範例 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> 。 為了獲得最佳效能，建議您使用使用者識別碼或使用者主體名稱 (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