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

Puede usar este cmdlet para configurar o deshabilitar la característica de autenticación previa en SharePoint Online. La deshabilitación se puede combinar con conmutadores para admitir la administración granular de la autenticación previa para aplicaciones y características específicas a nivel de inquilino.

Debe ser un administrador de SharePoint para ejecutar el cmdlet.

Configuración de direcciones URL de Microsoft Graph

Las API de archivos de Microsoft Graph pueden devolver direcciones URL que las aplicaciones usan para descargar, cargar, obtener una vista previa, transformar o supervisar operaciones de archivos. Algunas de estas direcciones URL han incluido históricamente tokens de autenticación previa o han redirigido a los clientes a direcciones URL autenticadas previamente.

Puede usar este cmdlet para empezar a recibir direcciones URL de Microsoft Graph de API compatibles para aplicaciones de terceros.

Comportamiento esperado de la API

API que devuelven direcciones URL

En el caso de las API con una alternativa de Microsoft Graph, si la configuración está habilitada para la aplicación de llamada, la respuesta usa una dirección URL de Microsoft Graph y la aplicación puede llamar a esa dirección URL mediante un token de acceso de Microsoft Graph adecuado.

Para las API sin una alternativa de Microsoft Graph, la dirección URL de SharePoint Online devuelta no contiene información de autenticación temporal. La aplicación debe obtener un token de acceso de Microsoft Entra adecuado para SharePoint Online e incluirlo al llamar a la URL devuelta.

API que actualmente devuelven una redirección HTTP 302

Las API afectadas devuelven contenido directamente en lugar de redirigir la aplicación a una dirección URL de autenticación temporal. Las aplicaciones no deben depender de interceptar la redirección, extraer un valor de autenticación temporal de la ubicación de redirección, pasar la URL redirigida a un cliente no autenticado o suponer que cada solicitud de contenido devuelve un código de estado HTTP 302. Las aplicaciones deben prepararse para procesar una respuesta de contenido correcta de la solicitud original de Microsoft Graph.

Solicitudes directas de API de SharePoint

La configuración de inquilino se aplica cuando la solicitud original se realiza a través de Microsoft Graph. No cambia las solicitudes que las aplicaciones realizan directamente a las API de SharePoint.

Escenarios de API afectados

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

En este ejemplo se deshabilita la autenticación previa en general y se agrega una configuración que permite que dos aplicaciones usen la autenticación previa para todas las características.

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

En este ejemplo se realiza la misma función que en el ejemplo 1, excepto que en este caso los modificadores de -ExcludedApps, -IncludedFeatures, y -ExcludedFeatures se agregan al cmdlet.

Se supone que estos modificadores toman el valor predeterminado de "" si no se usan con el cmdlet y el ejemplo 2 se utiliza para demostrar solo el conjunto completo de modificadores.

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

En este ejemplo se quitará un elemento existente de la lista actual de elementos. El modificador de eliminación puede quitar entradas de permiso o denegación de la lista.

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

En este ejemplo se deshabilita la autenticación previa en general y se permite que todas las aplicaciones, excepto una, usen la autenticación previa para todas las características excepto "Download" para y ."WebRenderingEmbed"

En este caso, a la aplicación "029e7c27-4b9c-4f8b-ba32-b96249468d42" siempre se le denegará el uso de la autenticación previa, ya que está excluida de la configuración de la lista de permitidos. Cualquier otra aplicación podrá usar la autenticación previa para cualquier característica que "Download" no sea y ."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"

En este ejemplo se deshabilita la autenticación previa en general, pero se superpone la configuración de la lista de permitidos y la de la lista de denegados. En primer lugar, "WebRenderingEmbed"permite que una aplicación use la autenticación previa para , "OfficeOnline", y "Download" características. Pero en la ejecución final del cmdlet, se impide que la misma aplicación use la autenticación previa para todas las características.

En este caso, la aplicación "029e7c27-4b9c-4f8b-ba32-b96249468d42" no podría usar la autenticación previa para ninguna de las características permitidas a pesar de tener la configuración. Esto se debe a que la lista de denegación tiene prioridad sobre la lista de permitidos.

Set-SPOTenantPreAuthSettings -IsDisabled $false

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

En este ejemplo se habilita la autenticación previa en general y se deniega el uso de la autenticación previa para todas las características y se deniega la solicitud que no proviene de una aplicación (por ejemplo, las solicitudes que llegan a través de un explorador).

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

En este ejemplo se habilita la configuración de dos aplicaciones, lo que significa que las API de Microsoft Graph admitidas devolverán direcciones URL de Graph a estas aplicaciones. El uso de una lista dirigida permite validar la compatibilidad de las aplicaciones antes de aplicar el comportamiento de forma más amplia.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $true -UseGraphUrlAppsList ""

En este ejemplo se habilita la configuración de todas las aplicaciones 3P al proporcionar una lista de aplicaciones vacía.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $false

En este ejemplo se muestra cómo dejar de devolver direcciones URL de Microsoft Graph mediante esta configuración.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Los -IncludedFeatures y -ExcludedFeatures usar los nombres de características de la tabla siguiente. Menciona explícitamente si la característica se romperá si se deshabilita a través del cmdlet de PowerShell.