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

Vous pouvez utiliser cette applet de commande pour configurer ou désactiver la fonctionnalité de pré-authentification dans SharePoint Online. La désactivation peut être combinée avec des commutateurs pour prendre en charge la gestion granulaire de la pré-authentification pour des applications et des fonctionnalités spécifiques au niveau du locataire.

Vous devez être administrateur SharePoint pour exécuter l’applet de commande.

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

Cet exemple désactive la pré-authentification globale et ajoute un paramètre qui permet à deux applications d’utiliser la pré-authentification pour toutes les fonctionnalités.

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

Cet exemple exécute la même fonction que l’exemple 1, sauf dans ce cas, les commutateurs pour -ExcludedApps, -IncludedFeatureset -ExcludedFeatures sont ajoutés à l’applet de commande .

Ces commutateurs sont supposés prendre la valeur par défaut de s’ils "" ne sont pas utilisés avec l’applet de commande et l’exemple 2 est utilisé uniquement pour illustrer l’ensemble complet des commutateurs.

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

Cet exemple supprime un élément existant de la liste actuelle d’éléments. Le commutateur de suppression peut supprimer les entrées d’autorisation ou de refus de la liste.

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

Cet exemple désactive la pré-authentification globale et permet à toutes les applications, sauf une, d’utiliser la pré-authentification pour toutes les fonctionnalités, à l’exception de "Download" et "WebRenderingEmbed".

Dans ce cas, l’application "029e7c27-4b9c-4f8b-ba32-b96249468d42" se verra toujours refuser l’utilisation de la pré-authentification, car elle est exclue du paramètre de liste verte. Toute autre application est autorisée à utiliser la pré-authentification pour n’importe quelle fonctionnalité à l’exception de "Download" et "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"

Cet exemple désactive la pré-authentification globale, mais contient un chevauchement entre les paramètres de la liste Verte et de la liste Refuser. Il permet d’abord à une application d’utiliser la pré-authentification pour les "OfficeOnline"fonctionnalités , "WebRenderingEmbed"et "Download" . Toutefois, lors de l’exécution finale de l’applet de commande, elle empêche la même application d’utiliser la pré-authentification pour toutes les fonctionnalités.

Dans ce cas, l’application "029e7c27-4b9c-4f8b-ba32-b96249468d42" ne serait pas autorisée à utiliser la pré-authentification pour l’une des fonctionnalités listées malgré le paramètre . Cela est dû au fait que la liste Refuser est prioritaire sur la liste Verte.

Set-SPOTenantPreAuthSettings -IsDisabled $false

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

Cet exemple active la pré-authentification globale et refuse aux demandes qui ne proviennent pas d’une application (par exemple, les demandes provenant d’un navigateur) d’utiliser la pré-authentification pour toutes les fonctionnalités.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

et -IncludedFeatures-ExcludedFeatures utilisent les noms de fonctionnalités du tableau suivant. Il indique explicitement si la fonctionnalité est interrompue si elle est désactivée via l’applet de commande PowerShell.