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"

Этот пример отключает предварительную проверку подлинности в целом и добавляет параметр, позволяющий двум приложениям использовать предварительную проверку подлинности для всех функций.

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"

В этом примере удаляется существующий элемент из текущего списка элементов. Параметр remove может удалять записи разрешения или запрета из списка.

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

Этот пример отключает предварительную проверку подлинности в целом и позволяет всем приложениям, кроме одного, использовать предварительную проверку подлинности для всех функций, "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.

-ExcludedFeatures Используйте -IncludedFeatures имена компонентов из следующей таблицы. В нем явно указывается, будет ли функция нарушена, если она отключена с помощью командлета PowerShell.