Get-EXORecipientPermission
此 Cmdlet 僅適用于 Exchange Online PowerShell 模組。 如需詳細資訊,請參閱關於 Exchange Online PowerShell 模組。
使用 Get-EXORecipientPermission Cmdlet 來檢視針對雲端式組織中使用者設定的 SendAs 許可權相關資訊。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Get-EXORecipientPermission
[-AccessRights <MultiValuedProperty>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[<CommonParameters>]
Get-EXORecipientPermission
[[-Identity] <String>]
[-AccessRights <MultiValuedProperty>]
[-ExternalDirectoryObjectId <Guid>]
[-PrimarySmtpAddress <String>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Description
此 Cmdlet 可用來檢視/管理針對雲端式組織中使用者設定的 SendAs 許可權相關資訊。 [傳送身分] 許可權可讓委派使用信箱來傳送郵件。 在此權限指派給代理人後,任何代理人自此信箱傳送的郵件都將顯示為由信箱擁有者傳送。 但是,此權限不允許代理人登入至使用者的信箱。 只允許使用者開啟信箱。 如果此權限已指派給群組,則代理人所傳送的郵件會顯示為由群組傳送。
範例
範例 1
Get-EXORecipientPermission -ResultSize 100
上述範例會依名稱排序次序,傳回前 100 位信箱使用者的收件者許可權。
參數
-AccessRights
AccessRights 參數會依許可權篩選結果。 這個參數的唯一有效值是 SendAs。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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 |
-Identity
Identity 參數會識別您想要檢視的收件者。 信任者參數所指定的使用者或群組對此收件者具有「傳送身分」許可權。 您可以指定任何類型的收件者,例如:
- 信箱
- 郵件使用者
- 郵件連絡人
- 通訊群組
- 動態通訊群組
為了獲得最佳效能,建議您使用下列值來識別收件者:
- 使用者識別碼或使用者主要名稱 (UPN)
- GUID
否則,您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- Domain\Username
- 電子郵件地址
- 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 |
-ResultSize
ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Trustee
信任者參數會依具有「傳送身分」許可權的使用者或群組來篩選結果。 您可以指定下列類型的使用者或群組:
- 信箱使用者
- 具有Microsoft帳戶的郵件使用者
- 安全性群組
您可以使用唯一識別使用者或群組的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- Domain\Username
- 電子郵件地址
- UPN) (使用者主體名稱
您必須使用此參數搭配 Identity、PrimarySmtpAddress、UserPrincipalName 或 ExternalDirectoryObjectId 參數。
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 |