Get-RecipientPermission
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-RecipientPermission コマンドレットを使用して、クラウドベースの組織内のユーザーに対して構成されている、送信者アクセス許可に関する情報を表示します。
注: PowerShell Exchange Onlineでは、このコマンドレットの代わりに Get-EXORecipientPermission コマンドレットを使用することをお勧めします。 詳細については、「Exchange Online PowerShell への接続」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-RecipientPermission
[[-Identity] <RecipientIdParameter>]
[-AccessRights <MultiValuedProperty>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-Trustee <SecurityPrincipalIdParameter>]
[<CommonParameters>]
説明
別のユーザーまたはグループに対する送信者アクセス許可を付与されているユーザーは、他のユーザーまたはグループから発信されたように見えるメッセージを送信できます。
注:
このコマンドレットは、トラスティ パラメーターで指定された受信者に複数の SecurityPrincipalIdParameter (Sid) 値がある場合、予期される結果を返しません。 トラスティ パラメーターを使用すると、指定したトラスティの Sid と受信者のアクセス制御リスト (ACL) レコードが比較されます。 受信者の Sid 値の一部が変更された場合、不一致があります。 回避策は、ユーザー プリンシパル名 (UPN) の値を使用せず、履歴用の Sid を含むすべての Sid を使用することです。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-RecipientPermission -Trustee "Kim Akers"
この例では、Kim Akers というユーザーが送信者アクセス許可を持つ受信者の一覧を表示します。 Kim は、この受信者から直接発信されたように見えるメッセージを送信できます。
例 2
Get-RecipientPermission "Help Desk"
この例では、Help Desk というメールボックスに対する送信者アクセス許可を持つユーザーの一覧を表示します。 結果として表示されたユーザーは、Help Desk メールボックスから直接送信されたように見えるメッセージを送信できます。
パラメーター
-AccessRights
適用対象: Exchange Online
AccessRights パラメーターは、アクセス許可で結果にフィルターを適用します。 このパラメーターの有効な値は SendAs のみです。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online
Identity パラメーターは、表示する受信者を識別します。 トラスティ パラメーターで指定されたユーザーまたはグループには、この受信者に対する Send As アクセス許可があります。 受信者の種類を指定できます。例:
- メールボックス
- メール ユーザー
- 外部の連絡先
- 配布グループ
- 動的配布グループ
受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
パラメーターのプロパティ
| 型: | RecipientIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ReadFromDomainController
適用対象: Exchange Online
ReadFromDomainController パラメーターには、ユーザー情報がユーザーのドメインのドメイン コントローラーから読み取られることを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Online
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Trustee
適用対象: Exchange Online
トラスティ パラメーターは、指定した受信者に対する Send As アクセス許可を持つユーザーによって結果をフィルター処理します。 このパラメーターには、次の種類のユーザーまたはグループ (セキュリティ プリンシパル) を指定できます。
- メールボックス ユーザー
- Microsoft アカウントを使用してユーザーにメールを送信する
- セキュリティ グループ
ユーザーまたはグループを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
パラメーターのプロパティ
| 型: | SecurityPrincipalIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。