Get-EXORecipientPermission
このコマンドレットは、Exchange Online PowerShell モジュールでのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
Get-EXORecipientPermission コマンドレットを使用して、クラウドベースのorganizationのユーザー用に構成されている SendAs アクセス許可に関する情報を表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-EXORecipientPermission
[-AccessRights <MultiValuedProperty>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[<CommonParameters>]
Identity
Get-EXORecipientPermission
[[-Identity] <String>]
[-AccessRights <MultiValuedProperty>]
[-ExternalDirectoryObjectId <Guid>]
[-PrimarySmtpAddress <String>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
説明
このコマンドレットは、クラウドベースのorganizationのユーザーに対して構成されている SendAs アクセス許可に関する情報を表示/管理するために使用されます。 [送信者] アクセス許可により、代理人はメールボックスを使用してメッセージを送信できます。 このアクセス許可が代理人に割り当てられた後、代理人がメールボックスから送信するすべてのメッセージは、メールボックスの所有者によって送信されたように見えます。 ただし、このアクセス許可は、代表者がユーザーのメールボックスにサインインすることは許可していません。 メールボックスを開くことができるのはユーザーのみです。 このアクセス許可がグループに割り当てられている場合、代理人によって送信されたメッセージはグループによって送信されたように見えます。
例
例 1
Get-EXORecipientPermission -ResultSize 100
上記の例では、名前の並べ替え順序で最初の 100 人のメールボックス ユーザーの受信者権限が返されます。
パラメーター
-AccessRights
適用対象: Exchange Online
AccessRights パラメーターは、アクセス許可で結果にフィルターを適用します。 このパラメーターの有効な値は SendAs のみです。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExternalDirectoryObjectId
適用対象: Exchange Online
ExternalDirectoryObjectId パラメーターは、Microsoft Entra ID の ObjectId で表示する受信者を識別します。
このパラメーターは、Identity、PrimarySmtpAddress、または UserPrincipalName パラメーターと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online
Identity パラメーターは、表示する受信者を識別します。 Trustee パラメーターで指定されたユーザーまたはグループには、この受信者に対する送信者アクセス許可があります。 受信者の種類を指定できます。例:
- メールボックス
- メール ユーザー
- メール連絡先
- 配布グループ
- 動的配布グループ
最適なパフォーマンスを得るには、次の値を使用して受信者を識別することをお勧めします:
- ユーザー ID またはユーザー プリンシパル名 (UPN)
- GUID
それ以外の場合は、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- ドメイン\ユーザー名
- 電子メール アドレス
- LegacyExchangeDN
- SamAccountName
このパラメーターを ExternalDirectoryObjectId、PrimarySmtpAddress、または UserPrincipalName パラメーターと一緒に使用することはできません。
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-PrimarySmtpAddress
適用対象: Exchange Online
PrimarySmtpAddress は、プライマリ SMTP メール アドレス ( navin@contoso.com など) で表示する受信者を識別します。
このパラメーターを ExternalDirectoryObjectId、Identity、または UserPrincipalName パラメーターと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | 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
- ドメイン\ユーザー名
- 電子メール アドレス
- ユーザー プリンシパル名 (UPN)
このパラメーターは、Identity、PrimarySmtpAddress、UserPrincipalName、または ExternalDirectoryObjectId パラメーターと共に使用する必要があります。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserPrincipalName
適用対象: Exchange Online
UserPrincipalName パラメーターは、UPN ( navin@contoso.onmicrosoft.com など) で表示する受信者を識別します。
このパラメーターを ExternalDirectoryObjectId、Identity、または PrimarySmtpAddress パラメーターと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。