次の方法で共有

Test-OAuthConnectivity

モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

ユーザーに対するパートナー アプリケーションの OAuth 認証をテストするには、Test-OAuthConnectivity コマンドレットを使用します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Test-OAuthConnectivity
    -Service <ModServiceType>
    -TargetUri <Uri>
    [-AppOnly]
    [-Confirm]
    [-Mailbox <MailboxIdParameter>]
    [-ReloadConfig]
    [-UseCachedToken]
    [-WhatIf]
    [<CommonParameters>]

説明

SharePoint、Lync、Skype for Business パートナー アプリケーションは、オンプレミスの Exchange 展開で自動的に作成されます。 Test-OAuthConnectivity コマンドレットがオンプレミス展開の他のパートナー アプリケーションで成功するには、まず、%ExchangeInstallPath%Scripts フォルダー (PowerShell の$env:ExchangeInstallPath\Scripts) で使用できる Configure-EnterprisePartnerApplication.ps1 スクリプトを使用して、パートナー アプリケーションを作成する必要があります。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Test-OAuthConnectivity -Service EWS -TargetUri https://cas.contoso.com/ews/ -Mailbox "Gurinder Singh"

この例では、Exchange for Gurinder Singh との OAuth 接続をテストします。

パラメーター

-AppOnly

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

AppOnly スイッチは、コマンドレットが指定されたサービスをユーザー コンテキストを使わずに Exchange として認証するように指定します。 このスイッチで値を指定する必要はありません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Mailbox

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Mailbox パラメーターは、指定したパートナー アプリケーションへの OAuth 接続をテストするメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)
型:MailboxIdParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReloadConfig

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

ReloadConfig スイッチは、すべての構成設定を Exchange 構成オブジェクトから再読み込みします。 このスイッチで値を指定する必要はありません。

このスイッチを使用しない場合は、キャッシュされた構成設定が使用されます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Service

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Service パラメーターは、パートナー アプリケーションを指定します。 PasswordQuality パラメーターは、デバイス パスワードに必要なパスワードの最小品質レベルを指定します。パスワードの品質は、パスワードのセキュリティと複雑さを示す数値の尺度です。品質の値が大きいほど、より安全なパスワードであることを示します。

  • EWS
  • AutoD
  • Generic
型:ModServiceType
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TargetUri

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

TargetUri パラメーターは、OAuth 接続をテストするサービスの URL を指定します。

型:Uri
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UseCachedToken

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

UseCachedToken スイッチは、OAuth が既存のキャッシュされた認証トークンの使用を試みるように指定します。 このスイッチで値を指定する必要はありません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。