Set-MailboxIRMAccess

模組:
Exchange PowerShell

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

使用 Set-MailboxIRMAccess Cmdlet 封鎖代理人存取其他信箱中受 IRM 保護的郵件， (共用信箱或使用者信箱，其中代理人具有完整存取權限) 。

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

語法

Default (預設值) 

Set-MailboxIRMAccess
    -AccessLevel <IRMAccessLevel>
    [-Identity] <MailboxIdParameter>
    -User <SecurityPrincipalIdParameter>
    [<CommonParameters>]

Description

注意事項

此 Cmdlet 僅適用具有信箱完整存取權限的代理人。 如需詳細資訊，請參閱在 Exchange Online 中管理收件者的權限。

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

範例

範例 1

Set-MailboxIRMAccess -Identity lynette@contoso.onmicrosoft.com -User chris@contoso.onmicrosoft.com -AccessLevel Block

此範例可防止代理人 Chris 在 Lynette 的信箱中讀取受 IRM 保護的郵件。

參數

-AccessLevel

適用：Exchange Online

AccessLevel 參數會指定代理人可以對 Identity 參數指定的信箱中受 IRM 保護的郵件執行的動作。

此參數的唯一值是封鎖，表示您只能使用此 Cmdlet 來封鎖對信箱中受 IRM 保護郵件的代理人存取。

若要允許存取信箱中受 IRM 保護的郵件，請使用 Remove-MailboxIRMAccess Cmdlet。

參數屬性

類型:IRMAccessLevel
預設值:None
接受的值:Block
支援萬用字元:False
不要顯示:False

參數集

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

-Identity

適用：Exchange Online

Identity 參數會指定要修改的信箱。 您可以使用可唯一識別信箱的任何值。 例如

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

參數屬性

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

參數集

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

-User

適用：Exchange Online

附註：使用此參數指定的代理人必須都擁有信箱的完整存取權限。 如需詳細資訊，請參閱在 Exchange Online 中管理收件者的權限。

User 參數會指定被封鎖而無法讀取信箱中受 IRM 保護郵件的代理人。 代理人必須是使用者信箱或郵件使用者。 您可以使用唯一識別代理人的任何值。 例如：

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

參數屬性

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

參數集

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

CommonParameters

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