Partager via

Convert-SPWebApplication

  • Référence
Module:
SharePointServer
S’applique à:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Convertit le mode d'authentification d'une application web.

Syntax

Convert-SPWebApplication
       -Identity <SPWebApplicationPipeBind>
       -From <String>
       -To <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Force]
       [-RetainPermissions]
       [-Database <SPContentDatabase>]
       [-MapList <String>]
       [-SiteSubsriptionId <Guid>]
       [-SkipPolicies]
       [-SkipSites]
       [-SourceSkipList <String>]
       [-TrustedProvider <SPTrustedIdentityTokenIssuerPipeBind>]
       [-LoggingDirectory <String>]
       [<CommonParameters>]

Description

Utilisez l’applet de commande Convert-SPWebApplication pour convertir le mode d’authentification d’une application web en mode d’authentification revendications Windows et migrer les comptes d’utilisateur dans la base de données de contenu vers des valeurs codées par revendications.

Lors de la conservation des autorisations, les utilisateurs au sein de Sites ne sont convertis que si le compte source est activé et interrogeable par SharePoint. Par exemple, si le compte Active Directory est supprimé ou désactivé avant une conversion windows classique en revendications Windows, le compte de la base de données n’est pas mis à jour au format Revendications.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

------------EXEMPLE 1-------

Convert-SPWebApplication -Identity "https://<webappurl>" -To Claims -RetainPermissions

Cet exemple convertit une application web spécifiée par le paramètre Identity pour utiliser le mode d'authentification de revendication.

------------EXEMPLE 2-------

Convert-SPWebApplication -Identity "https://<webappurl>" -From Legacy -To Claims -RetainPermissions

Cet exemple convertit une application web spécifiée par le paramètre Identity de Classic Authentification Windows en mode d’authentification Revendications tout en conservant les autorisations. Le paramètre -From est requis après l’application de la mise à jour de sécurité MS04-022 ou de la mise à jour cumulative d’avril 2014 pour SharePoint Server 2013. Cela est obligatoire pour toutes les versions de SharePoint Server 2016.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Database

Spécifie le nom de la base de données de contenu à migrer.

Type:SPContentDatabase
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

Force la conversion de l'application web.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-From

Spécifie la méthode d’authentification à partir de laquelle effectuer la conversion.

Les valeurs valides pour ce paramètre sont les suivantes.

Hérité, Claims-Windows, Claims-Trusted-Default

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Spécifie l'URL de l'application web à convertir, par exemple : https://mysite/app1

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-LoggingDirectory

Spécifie un répertoire dans lequel les journaux détaillés sur les résultats de la migration seront écrits.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-MapList

Spécifie un fichier contenant comme liste de lignes au format suivant : user-key, migrated-user-name, migrated-user-key.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RetainPermissions

Spécifie le compte sous lequel l'applet de commande s'exécute et conserve l'autorisation dans l'application web.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteSubsriptionId

Spécifie le GUID de l’abonnement au site.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SkipPolicies

Spécifie que les stratégies de sécurité SPWebApplication ne seront pas migrées.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SkipSites

Spécifie que les SPSites de SPWebApplication ne seront pas migrés.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourceSkipList

Spécifie un fichier contenant comme liste de lignes au format suivant : user-key.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-To

Spécifie la méthode d’authentification vers laquelle effectuer la conversion.

Les valeurs valides pour ce paramètre sont les suivantes.

Claims, Claims-Windows, Claims-Trusted-Default, Claims-SharePoint-Online

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TrustedProvider

Lorsque vous migrez à partir d’un fournisseur de connexion approuvé, vous spécifiez le fournisseur de connexion approuvé.

Type:SPTrustedIdentityTokenIssuerPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019