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>]

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

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

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"

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

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

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