Get-EXOMailboxFolderPermission
此 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\ReportsThis 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 |