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

È possibile usare questo cmdlet per configurare o disabilitare la funzionalità di preautenticazione in SharePoint Online. La disabilitazione può essere combinata con i commutatori per supportare la gestione granulare della preautenticazione per app e funzionalità specifiche a livello di tenant.

Per eseguire il cmdlet, è necessario essere un amministratore di SharePoint.

Impostazioni URL di Microsoft Graph

Le API dei file di Microsoft Graph possono restituire gli URL utilizzati dalle applicazioni per scaricare, caricare, visualizzare in anteprima, trasformare o monitorare le operazioni sui file. Alcuni di questi URL hanno storicamente incluso token di preautenticazione o reindirizzato client a URL preautenticati.

È possibile usare questo cmdlet per iniziare a ricevere gli URL di Microsoft Graph dalle API supportate per le applicazioni di terze parti.

Comportamento API previsto

API che restituiscono gli URL

Per le API con un'alternativa a Microsoft Graph, se l'impostazione è abilitata per l'applicazione chiamante, la risposta usa un URL di Microsoft Graph e l'applicazione può chiamare tale URL usando un token di accesso di Microsoft Graph appropriato.

Per le API senza un'alternativa a Microsoft Graph, l'URL di SharePoint Online restituito non contiene informazioni di autenticazione temporanee. L'applicazione deve ottenere un token di accesso Microsoft Entra appropriato per SharePoint Online e includerlo quando chiama l'URL restituito.

API che attualmente restituiscono un reindirizzamento HTTP 302

Le API interessate restituiscono il contenuto direttamente anziché reindirizzare l'applicazione a un URL di autenticazione temporaneo. Le applicazioni non devono dipendere dall'intercettazione del reindirizzamento, dall'estrazione di un valore di autenticazione temporaneo dal percorso di reindirizzamento, dal passaggio dell'URL reindirizzato a un client non autenticato o dal presupposto che ogni richiesta di contenuto restituisca un codice di stato HTTP 302. Le applicazioni devono essere preparate per elaborare una risposta di contenuto riuscita dalla richiesta originale di Microsoft Graph.

Richieste API SharePoint dirette

L'impostazione del tenant si applica quando la richiesta originale viene effettuata tramite Microsoft Graph. Non modifica le richieste che le applicazioni inviano direttamente alle API di SharePoint.

Scenari API interessati

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

In questo esempio viene disabilitata la preautenticazione complessiva e viene aggiunta un'impostazione che consente a due app di usare la preautenticazione per tutte le funzionalità.

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

In questo esempio viene eseguita la stessa funzione dell'esempio 1, ad eccezione del fatto che in questo caso le opzioni per -ExcludedApps, -IncludedFeatures, e -ExcludedFeatures vengono aggiunte al cmdlet.

Si presuppone che queste opzioni accettino il valore predefinito di "" se non vengono usate con il cmdlet e l'esempio 2 viene utilizzato solo per dimostrare il set completo di opzioni.

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

In questo esempio verrà rimosso un elemento esistente dall'elenco di elementi corrente. L'opzione remove consente di rimuovere le voci consentite o negate dall'elenco.

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

Questo esempio disabilita la preautenticazione complessiva e consente a tutte le app, tranne una, di usare la preautenticazione per tutte le funzionalità tranne "Download" e "WebRenderingEmbed".

In questo caso, all'app "029e7c27-4b9c-4f8b-ba32-b96249468d42" verrà sempre negato l'uso della preautenticazione perché è esclusa dall'impostazione dell'elenco Consenti. Qualsiasi altra app sarà autorizzata a usare la preautenticazione per qualsiasi funzionalità tranne "Download" e "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"

In questo esempio viene disabilitata complessivamente la preautenticazione, ma viene contenuta una sovrapposizione tra le impostazioni nell'elenco Consenti e nell'elenco Indirizzi non consentiti. Prima di tutto, consente a un'app di usare la preautenticazione per le funzionalità e "WebRenderingEmbed""Download" ."OfficeOnline" Tuttavia, nell'esecuzione finale del cmdlet, impedisce alla stessa app di usare la preautenticazione per tutte le funzionalità.

In questo caso, l'app "029e7c27-4b9c-4f8b-ba32-b96249468d42" non sarà autorizzata a usare la preautenticazione per una delle funzionalità elencate nella community nonostante disponga dell'impostazione. Ciò è dovuto al fatto che l'elenco degli indirizzi non consentiti ha la precedenza sull'elenco Consenti.

Set-SPOTenantPreAuthSettings -IsDisabled $false

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

Questo esempio abilita la preautenticazione complessiva e nega alle richieste che non provengono da un'app (ad esempio, le richieste provenienti da un browser) l'uso della preautenticazione per tutte le funzionalità.

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

Questo esempio abilita l'impostazione per due app, il che significa che le API di Microsoft Graph supportate restituiranno gli URL di Graph a queste app. L'uso di un elenco di destinazione consente di convalidare la compatibilità delle applicazioni prima di applicare il comportamento in modo più ampio.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $true -UseGraphUrlAppsList ""

In questo esempio viene abilitata l'impostazione per tutte le applicazioni 3P fornendo un elenco di applicazioni vuoto.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $false

Questo esempio mostra come interrompere la restituzione degli URL di Microsoft Graph tramite questa impostazione.

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

-ExcludedFeatures e -IncludedFeatures usano i nomi delle funzionalità della tabella seguente. Indica esplicitamente se la funzionalità verrà danneggiata se viene disabilitata tramite il cmdlet PowerShell.