Get-RecipientPermission
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-RecipientPermission コマンドレットを使用して、クラウドベースの組織内のユーザーに対して構成されている、送信者アクセス許可に関する情報を表示します。
注: Exchange Online PowerShell では、このコマンドレットの代わりに Get-EXORecipientPermission コマンドレットを使用することをお勧めします。 詳細については、「Exchange Online PowerShell への接続」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-RecipientPermission
[[-Identity] <RecipientIdParameter>]
[-AccessRights <MultiValuedProperty>]
[-IncludeTrusteeWithPrimarySmtpAddress]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-Trustee <SecurityPrincipalIdParameter>]
[<CommonParameters>]
説明
別のユーザーまたはグループに対する送信者アクセス許可を付与されているユーザーは、他のユーザーまたはグループから発信されたように見えるメッセージを送信できます。
注:
Trustee パラメーターで指定された受信者に複数の SecurityPrincipalIdParameter (Sid) 値がある場合、このコマンドレットは期待される結果を返しません。 Trustee パラメータを使用すると、指定した Trustee の 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 パラメーターは、表示する受信者を識別します。 Trustee パラメーターで指定されたユーザーまたはグループには、この受信者に対する送信者アクセス許可があります。 受信者の種類を指定できます。例:
- メールボックス
- メール ユーザー
- 外部の連絡先
- 配布グループ
- 動的配布グループ
受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | RecipientIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IncludeTrusteeWithPrimarySmtpAddress
適用対象: Exchange Online
{{ fill IncludeTrusteeWithPrimarySmtpAddress description }}
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | 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
Trustee パラメーターは、指定した受信者の送信者アクセス許可を持つユーザーによって結果をフィルター処理します。 このパラメーターには、次の種類のユーザーまたはグループ (セキュリティ プリンシパル) を指定できます。
- メールボックス ユーザー
- 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。