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 パラメーターは、表示する受信者を識別します。 トラスティ パラメーターで指定されたユーザーまたはグループには、この受信者に対する Send As アクセス許可があります。 受信者の種類を指定できます。例:
- メールボックス
- メール ユーザー
- メール連絡先
- 配布グループ
- 動的配布グループ
最適なパフォーマンスを得るには、次の値を使用して受信者を識別することをお勧めします。
- ユーザー ID またはユーザー プリンシパル名 (UPN)
- GUID
それ以外の場合は、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- ドメイン\ユーザー名
- 電子メール アドレス
- LegacyExchangeDN
- SamAccountName
ExternalDirectoryObjectId、PrimarySmtpAddress、または UserPrincipalName パラメーターでは、このパラメーターを使用できません。
パラメーターのプロパティ
型: | 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
トラスティ パラメーターは、Send As アクセス許可を持つユーザーまたはグループによって結果をフィルター処理します。 次の種類のユーザーまたはグループを指定できます。
- メールボックス ユーザー
- 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」を参照してください。