Get-RecipientPermission

此指令程式只能在雲端式服務中使用。

使用 Get-RecipientPermission Cmdlet 來檢視有關為雲端組織中的使用者設定的 SendAs 權限的資訊。

注意:在 Exchange Online PowerShell 中,建議您使用 Get-EXORecipientPermission Cmdlet 而非此 Cmdlet。 如需詳細資訊,請參閱<連線至 Exchange Online PowerShell>。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。

語法

Default (預設值)

Get-RecipientPermission
    [[-Identity] <RecipientIdParameter>]
    [-AccessRights <MultiValuedProperty>]
    [-IncludeTrusteeWithPrimarySmtpAddress]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-Trustee <SecurityPrincipalIdParameter>]
    [<CommonParameters>]

Description

提供使用者用於其他使用者或群組的 SendAs 權限時,該使用者便可以傳送來自其他使用者或群組的訊息。

注意事項

當 Trustee 參數指定的收件者具有多個 SecurityPrincipalIdParameter (Sid) 值時,此 Cmdlet 不會傳回預期結果。 當您使用 Trustee 參數時,此命令會將指定受託人的 SID 與收件者的存取控制清單 (ACL) 記錄做比較。 如果某些收件者的 Sid 值已變更,則表示不相符。 因應措施是不要使用使用者主體名稱 (UPN) 值,而是使用所有 Sid,包括用於歷程記錄的 Sid。

您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-RecipientPermission -Trustee "Kim Akers"

此範例會列出使用者 Kim Akers 具有 SendAs 權限的收件者。 Kim 可以傳送看似直接來自收件者的郵件。

範例 2

Get-RecipientPermission "Help Desk"

此範例列出在信箱技術支援中心擁有 SendAs 權限的使用者。 列出的使用者可以傳送看似直接來自 [技術支援中心] 信箱的郵件。

參數

-AccessRights

適用:Exchange Online

AccessRights 參數會依權限篩選結果。 此參數的唯一有效值是 SendAs。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用:Exchange Online

Identity 參數可識別您要檢視的收件者。 由 Trustee 參數指定的使用者或群組擁有此收件者的「傳送為」權限。 您可以指定任何類型的收件者,例如:

  • 信箱
  • 郵件使用者
  • 外部連絡人
  • 通訊群組
  • 動態通訊群組

您可以使用唯一識別收件者的任何值。 例如:

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 標準 DN
  • GUID

警告: Identity 參數的值 $null 或不存在的值會傳回 所有 物件,就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤,且不包含不存在的$null值。

參數屬性

類型:RecipientIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-IncludeTrusteeWithPrimarySmtpAddress

適用:Exchange Online

{{ Fill IncludeTrusteeWithPrimarySmtpAddress 描述 }}

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ReadFromDomainController

適用:Exchange Online

ReadFromDomainController 參數會指定從使用者網域的網域控制站讀取使用者資訊。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用:Exchange Online

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Trustee

適用:Exchange Online

Trustee 參數會根據誰對指定的收件者具有 [傳送為] 權限來篩選結果。 您可以指定下列類型的使用者或群組 (為此參數) 安全性主體:

  • 信箱使用者
  • 郵件使用者擁有 Microsoft 帳戶
  • 安全性群組

您可以使用唯一識別使用者或群組的任何值。 例如:

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 網域\使用者名稱
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

參數屬性

類型:SecurityPrincipalIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

Input types

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。