Partager via

Convert-SPWebApplication

Module:
SharePointServer module

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

Syntaxe

Default (Par défaut) 

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

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Database

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPContentDatabase
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Force la conversion de l'application web.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-From

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPWebApplicationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LoggingDirectory

Applicable : SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MapList

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RetainPermissions

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SiteSubsriptionId

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SkipPolicies

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SkipSites

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SourceSkipList

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-To

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TrustedProvider

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPTrustedIdentityTokenIssuerPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

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.