Get-MailboxIRMAccess
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-MailboxIRMAccess コマンドレットを使用して、他のメールボックス (代理人がフル アクセス許可を持つ共有メールボックスまたはユーザー メールボックス) 内の IRM で保護されたメッセージへの代理人アクセスを表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-MailboxIRMAccess
[[-Identity] <MailboxIdParameter>]
[-User <SecurityPrincipalIdParameter>]
[<CommonParameters>]
説明
注:
このコマンドレットは、メールボックスへのフル アクセス許可を既に持っている代理人に対してのみ機能します。 詳細については、「Exchange Online で受信者のアクセス許可を管理する」を参照してください。
このコマンドレットの結果に表示されないメールボックスへのフル アクセス許可を持つ代理人は、IRM で保護されたメッセージにアクセスできます。 メールボックス内の IRM で保護されたメッセージの読み取りがブロックされているフル アクセス代理人のみが結果に表示されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-MailboxIRMAccess -Identity lynette@contoso.onmicrosoft.com
次の例では、Lynette のメールボックス内の IRM で保護されたメッセージへの代理人アクセスに関する情報を返します。
- 結果に表示されるフル アクセスの代理人は、メールボックス内の IRM で保護されたメッセージを読むことができなくなります。
- 結果に表示されないフル アクセス代理人は、メールボックスで IRM で保護されたメッセージを読むことができます。
例 2
Get-MailboxIRMAccess -Identity lynette@contoso.onmicrosoft.com -User chris@contoso.onmicrosoft.com
この例では、Lynette のメールボックス内の IRM で保護されたメッセージへの Chris 代理人のアクセスに関する情報を返します。
パラメーター
-Identity
適用対象: Exchange Online
Identity パラメーターは、IRM で保護されたメッセージへの委任アクセスを表示するメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 たとえば、
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | MailboxIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-User
適用対象: Exchange Online
User パラメーターは、指定されたデリゲートによってメールボックスの結果をフィルター処理します。 代理人は、ユーザー メールボックスまたはメール ユーザーである必要があります。 代理人を一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
パラメーターのプロパティ
| 型: | SecurityPrincipalIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。