Set-SPOTenantPreAuthSettings

Set-SPOTenantPreAuthSettings
    -IsDisabled <Boolean>
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Type <TenantPreAuthSettingsListType>
    [-Add]
    [-IncludedApps <String>]
    [-ExcludedApps <String>]
    [-IncludedFeatures <String>]
    [-ExcludedFeatures <String>]
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Id <String>
    [-Remove]
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    [-UseGraphUrlIsEnabled <Boolean>]
    [-UseGraphUrlAppsList <String>]
    [<CommonParameters>]

このコマンドレットを使用して、SharePoint Online 内の事前認証機能を構成または無効にできます。 無効化をスイッチと組み合わせて、テナント レベルで特定のアプリや機能のきめ細かな認証前管理をサポートできます。

コマンドレットを実行するには、SharePoint 管理者である必要があります。

Microsoft Graph の URL 設定

Microsoft Graph ファイル API は、アプリケーションがファイル操作のダウンロード、アップロード、プレビュー、変換、または監視に使用する URL を返すことができます。 これらの URL の中には、これまで事前認証トークンが含まれていたり、クライアントを事前認証された URL にリダイレクトしたりするものがあります。

このコマンドレットを使用して、サード パーティ製アプリケーションのサポートされている API からの Microsoft Graph URL の受信を開始できます。

予期される API の動作

URL を返す API

Microsoft Graph の代替を使用する API の場合、呼び出し元のアプリケーションに対して設定が有効になっている場合、応答では Microsoft Graph URL が使用され、アプリケーションは適切な Microsoft Graph アクセス トークンを使用してその URL を呼び出すことができます。

代替 Microsoft Graph がない API の場合、返される SharePoint Online URL には一時的な認証情報は含まれません。 アプリケーションは、SharePoint Online 用の適切な Microsoft Entra アクセス トークンを取得し、返された URL を呼び出すときに含める必要があります。

現在 HTTP 302 リダイレクトを返している API

影響を受ける API は、アプリケーションを一時的な認証 URL にリダイレクトするのではなく、コンテンツを直接返します。 アプリケーションは、リダイレクトのインターセプト、リダイレクトの場所からの一時的な認証値の抽出、リダイレクトされた URL を未認証のクライアントに渡すこと、またはすべてのコンテンツ要求が HTTP 302 ステータス コードを返すものであると想定することに依存してはなりません。 アプリケーションは、元の Microsoft Graph 要求からのコンテンツ応答が成功した場合を処理するために準備しておく必要があります。

SharePoint API の直接要求

テナント設定は、元の要求が Microsoft Graph を介して行われた場合に適用されます。 アプリケーションが SharePoint API に対して直接行う要求を変更することはありません。

影響を受ける API シナリオ

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

この例では、事前認証を全体的に無効にし、2 つのアプリがすべての機能で事前認証を使用できるようにする設定を追加します。

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e" -ExcludedApps "" -IncludedFeatures "" -ExcludedFeatures ""

この例では例 1 と同じ機能を実行しますが、この場合は -ExcludedApps、 -IncludedFeatures、および -ExcludedFeatures のスイッチがコマンドレットに追加されます。

これらのスイッチは、コマンドレットで使用しない場合、既定値の "" を使用すると見なされます。例 2 は、スイッチの完全なセットを示すためにのみ使用します。

Set-SPOTenantPreAuthSettings -Remove -Id "368dde6f-c857-4383-a8a7-02a04a294e6d"

この例では、現在のアイテム リストから既存のアイテムを削除します。 削除スイッチを使用すると、許可または拒否のエントリを一覧から削除できます。

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -ExcludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -ExcludedFeatures "Download,WebRenderingEmbed"

この例では、事前認証を全体的に無効にし、1 つのアプリを除くすべてのアプリが "Download" と "WebRenderingEmbed" を除くすべての機能で事前認証を使用できるようにします。

この場合、アプリ "029e7c27-4b9c-4f8b-ba32-b96249468d42" は許可リスト設定から除外されるため、事前認証の使用は常に拒否されます。 他のアプリは、 "Download" と "WebRenderingEmbed" 以外のすべての機能に事前認証を使用できます。

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -IncludedFeatures "OfficeOnline,WebRenderingEmbed,Download"

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

この例では事前認証を全体的に無効にしますが、[許可] リストと拒否リストの設定が重複しています。 最初に、アプリが "OfficeOnline"、 "WebRenderingEmbed"、 "Download" 機能に事前認証を使用することを許可します。 ただし、コマンドレットの最終的な実行では、同じアプリがすべての機能で事前認証を使用することが拒否されます。

この場合、アプリ "029e7c27-4b9c-4f8b-ba32-b96249468d42" は、設定があるにもかかわらず、許可リストに登録されている機能に対して事前認証を使用することを許可されません。 これは、拒否リストが許可リストよりも優先されるためです。

Set-SPOTenantPreAuthSettings -IsDisabled $false

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "Empty"

この例では、事前認証を全体的に有効にし、アプリからではない要求 (ブラウザー経由の要求など) がすべての機能で事前認証を使用することを拒否します。

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $true -UseGraphUrlAppsList "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

この例では、2 つのアプリの設定を有効にします。つまり、サポートされている Microsoft Graph API は、これらのアプリに Graph URL を返します。 ターゲット リストを使用すると、動作をより広範に適用する前にアプリケーションの互換性を検証できます。

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $true -UseGraphUrlAppsList ""

この例では、空のアプリケーション リストを指定することで、すべての 3P アプリケーションの設定を有効にします。

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $false

この例では、この設定を使用して Microsoft Graph URL の返品を停止する方法を示します。

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。

-IncludedFeaturesと-ExcludedFeaturesでは、次の表の機能名が使用されます。 PowerShell コマンドレットを使用して無効にした場合に機能が壊れるかどうかについて明示的に言及しています。