Mettre à niveau des applications de service vers SharePoint Server Édition d’abonnement

Article
07/06/2024

S’APPLIQUE À : no-img-13 2013 no-img-16 2016 no-img-19 2019 oui-img-se Édition d’abonnement no-img-sop SharePoint dans Microsoft 365

Lorsque vous effectuez une mise à niveau de SharePoint Server 2019 ou SharePoint Server 2016 vers SharePoint Server Édition d’abonnement, vous devez utiliser une mise à niveau d’attachement de base de données, ce qui signifie que vous mettez à niveau uniquement le contenu de votre environnement et non les paramètres de configuration. Après avoir configuré l’environnement SharePoint Server Édition d’abonnement et copié les bases de données de contenu et d’application de service, vous pouvez mettre à niveau les applications de service vers SharePoint Server Édition d’abonnement. Cet article contient les étapes à suivre pour mettre à niveau les applications de service.

Phase 3 du processus de mise à niveau : mise à niveau des applications de service

Phase 3 du processus de mise à niveau : mise à niveau des applications de service

Phases	Description
	Il s’agit de la troisième phase du processus de mise à niveau des données et des sites SharePoint Server 2019 et SharePoint Server 2016 vers SharePoint Server Édition d’abonnement. Ce processus inclut les phases suivantes à exécuter dans l'ordre : Créer la batterie de serveurs SharePoint Server Édition d’abonnement pour une mise à niveau d’attachement de base de données Copier des bases de données vers la nouvelle batterie de serveurs pour la mise à niveau vers SharePoint Server Édition d’abonnement Mettre à niveau des applications de service vers SharePoint Server Édition d’abonnement (cette phase) Mettre à niveau les bases de données de contenu vers SharePoint Server Édition d’abonnement Pour obtenir une vue d’ensemble de l’ensemble du processus, voir Vue d’ensemble du processus de mise à niveau vers SharePoint Server Édition d’abonnement.

Phases

Description

Il s’agit de la troisième phase du processus de mise à niveau des données et des sites SharePoint Server 2019 et SharePoint Server 2016 vers SharePoint Server Édition d’abonnement. Ce processus inclut les phases suivantes à exécuter dans l'ordre :
Créer la batterie de serveurs SharePoint Server Édition d’abonnement pour une mise à niveau d’attachement de base de données
Copier des bases de données vers la nouvelle batterie de serveurs pour la mise à niveau vers SharePoint Server Édition d’abonnement
Mettre à niveau des applications de service vers SharePoint Server Édition d’abonnement (cette phase)
Mettre à niveau les bases de données de contenu vers SharePoint Server Édition d’abonnement

Pour obtenir une vue d’ensemble de l’ensemble du processus, voir Vue d’ensemble du processus de mise à niveau vers SharePoint Server Édition d’abonnement.

Avant de commencer

Avant de mettre à niveau les applications de service, passez en revue les informations suivantes et prenez les mesures recommandées.

Vérifiez que le compte que vous utilisez pour effectuer les étapes décrites dans cet article est membre du groupe Administrateurs de batterie dans le site web Administration centrale.
Déterminez quel pool d'applications de service utiliser pour les applications de service mises à niveau. Les procédures ci-dessous utilisent le pool d'applications par défaut pour les applications de service, à savoir les « services web SharePoint par défaut ». Vous pouvez afficher la liste des pools d'applications de service disponibles à l'aide l'applet de commande Get-SPServiceApplicationPool dans PowerShell. Ou vous pouvez créer un pool d'applications de service à l'aide de l'applet de commande New-SPServiceApplicationPool. Pour plus d'informations, voir Get-SPServiceApplicationPool et New-SPServiceApplicationPool.

Conseil

[!CONSEIL] Tout au long du présent article, des variables (comme $applicationPool, $sss, $upa, etc.) sont utilisées dans les applets de commande PowerShell pour économiser temps et efforts. Vous n'êtes pas obligé d'utiliser ces variables si vous ne préférez pas le faire. Toutefois, si vous n’utilisez pas ces variables, vous devez utiliser des ID pour les applications de service et les proxys d’application de service lorsque vous spécifiez les paramètres Identity . Chaque procédure comporte des informations sur les variables utilisées ou les applets de commande alternatives à utiliser pour rechercher les ID requis. > En outre, de nombreuses procédures de cet article incluent une étape pour définir la variable $applicationPool. Si vous exécutez toutes ces procédures au cours de la même session de PowerShell et que vous voulez utiliser le même pool d'applications pour toutes les applications de service, il n'est pas nécessaire de répéter cette étape dans chaque procédure. Vous pouvez en effet définir cette variable une seule fois au départ, puis l'utiliser au cours de toutes les procédures de cet article.

À propos de la mise à niveau des bases de données des applications de service

Pour mettre à niveau une base de données d'application de service, vous devez créer une application de service et indiquer le nom de la base de données existante à utiliser pour cette application. Une fois que l'application de service est créée, la mise à niveau de la base de données associée commence. Ce processus se déroule en plusieurs étapes.

Notes

[!REMARQUE] Word Automation Services et les services de traduction automatique ne peuvent pas être mis à niveau. Une nouvelle instance de service devra être créée.

Importante

Les étapes suivantes s'appliquent uniquement au type de rôle serveur personnalisé. Pour plus d’informations sur les types de rôles serveur, voir Planning for a MinRole server deployment in SharePoint Server 2016 and SharePoint Server 2019

Démarrez les instances de service.

La première étape consiste à démarrer des instances de service pour les quatre applications de service que vous pouvez mettre à niveau : le service Business Data Connectivity, le service web de métadonnées gérées, le service Banque d’informations sécurisé et le service de recherche. La plupart de ces instances de service peuvent être démarrées à partir de l’Administration centrale. Toutefois, l’instance du service Recherche SharePoint Server doit être démarrée à l’aide de PowerShell.
Créez les applications de service et mettez à niveau les bases de données.

Après avoir démarré les instances de service, l'étape suivante consiste à créer les applications de service et à mettre à niveau les bases de données associées. Vous devez utiliser PowerShell pour restaurer les bases de données des applications de service.
Créez des proxys pour les applications de service.

Lorsque vous avez terminé la mise à niveau des bases de données des applications de service, vous devez créer les proxys pour les applications de service et les ajouter au groupe de proxys par défaut. Des proxys sont nécessaires pour les applications de service suivantes :
- Application de service de métadonnées gérées
- Application de service de recherche
- Application de service Banque d'informations sécurisée
  
  Lorsque vous créez l'application de service Service Business Data Connectivity, un proxy est automatiquement créé et ajouté au groupe de proxys par défaut.
Vérifier que les proxys sont dans le groupe par défaut

Ces différentes étapes sont décrites dans les sections suivantes.

Démarrer les instances de service

Utilisez l’une des procédures suivantes pour démarrer les instances de service.

Pour démarrer les instances d'application de service à partir de l'Administration centrale

Démarrez l’Administration centrale de SharePoint 2019.
Dans l’Administration centrale de SharePoint 2019, dans la page Gestion des applications, dans la section Applications de service , cliquez sur Gérer les services sur le serveur.
En regard de Service Business Data Connectivity, cliquez sur Démarrer.
En regard de Service Web de métadonnées gérées, cliquez sur Démarrer.
En regard du service Banque d'informations sécurisée, cliquez sur Démarrer.

Vous devez démarrer l'instance de service de recherche avec PowerShell, car il est impossible de le faire à partir de l'Administration centrale lorsque aucune application de service de recherche n'existe.

Conseil

Lorsque vous utilisez MinRoles, l’option Démarrer peut ne pas être disponible, car elle est gérée par la batterie de serveurs. Une fois l’application de service associée créée, elle démarre automatiquement l’instance de service.

Pour démarrer l'instance de service de recherche à l'aide de PowerShell

Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
  
  Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server Édition d’abonnement.
  
  Notes
  
  [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Subscription Edition Management Shell.
Pour démarrer l'instance de service de recherche, à l'invite de commandes Microsoft PowerShell, tapez les commandes suivantes les unes après les autres, en appuyant sur Entrée à la fin de chacune d'elles :
```
$SearchInst = Get-SPEnterpriseSearchServiceInstance
    # Stores the identity for the Search service instance on this server as a variable
```
```
Start-SPServiceInstance $SearchInst
    # Starts the service instance
```
Pour plus d’informations, consultez Get-SPEnterpriseSearchServiceInstance et Start-SPServiceInstance.

Mettre à niveau l'application de service Banque d'informations sécurisée.

Pour mettre à niveau l'application de service Banque d'informations sécurisée, vous devez créer l'application de service et mettre à niveau la base de données associée, créer un proxy et l'ajouter au groupe de proxys par défaut, puis restaurer la phrase secrète de l'environnement précédent.

Pour mettre à niveau l'application de service Banque d'informations sécurisée à l'aide de PowerShell

Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
  
  Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.
  
  Notes
  
  [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Subscription Edition Management Shell.
Pour stocker le pool d'applications à utiliser en tant que variable pour cette application de service, à l'invite de commandes Microsoft PowerShell, tapez la commande suivante :
```
$applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
```
Où :
- SharePoint Web Services default est le nom du pool d'applications de service qui contiendra les nouvelles applications de service. Il s'agit du pool d'applications de service par défaut. Vous pouvez en spécifier un autre.
Cette applet de commande définit le pool d'applications de service en tant que variable réutilisable dans les applets de commande qui suivent. Si vous avez plusieurs pools d'applications et que vous devez utiliser un pool d'applications différent pour une application de service particulière, répétez cette étape dans la procédure pour créer chaque application de service afin d'utiliser le pool d'applications approprié.
Pour mettre à niveau l’application de service Banque d’informations sécurisé, à l’invite de commandes PowerShell, tapez la commande suivante :
```
$sss = New-SPSecureStoreServiceApplication -Name 'Secure Store' -ApplicationPool $applicationPool -DatabaseName 'SecureStore_Upgrade_DB' -AuditingEnabled
```
Où :
- SecureStore est le nom que vous souhaitez donner à la nouvelle application de service Banque d'informations sécurisée.
- $applicationpool est la variable que vous avez définie précédemment pour identifier le pool d’applications de service à utiliser.
  
  Conseil
  
  [!CONSEIL] Si vous n'utilisez pas la variable $applicationPool, alors vous devez spécifier le nom d'un pool d'applications de service existant au format ' Application Pool Name'. Pour afficher la liste des pools d'applications de service, vous pouvez exécuter l'applet de commande Get-SPServiceApplicationPool.
- SecureStore_Upgrade_DB est le nom de la base de données d'application de service que vous souhaitez mettre à niveau.
Cette commande définit une variable $sss que vous utiliserez plus tard lors de la création du proxy.

Pour plus d'informations, voir New-SPSecureStoreApplication.
Tapez la commande suivante pour créer un proxy pour l'application de service Banque d'informations sécurisée :
```
$sssp = New-SPSecureStoreServiceApplicationProxy -Name ProxyName -ServiceApplication $sss -DefaultProxyGroup
```
Où :
- ProxyName est le nom du proxy que vous souhaitez utiliser.
- $sss est la variable que vous avez définie précédemment pour identifier la nouvelle application de service Banque d'informations sécurisée.
  
  Conseil
  
  [!CONSEIL] Si vous n'utilisez pas de variable $sss, vous devez identifier l'application de service Banque d'informations sécurisée avec un ID au lieu d'un nom. Pour rechercher cet ID, exécutez l'applet de commande Get-SPServiceApplication qui affiche la liste de tous les ID d'application de service.
- DefaultProxyGroup ajoute le proxy d'application de service Banque d'informations sécurisée au groupe de proxys par défaut pour la batterie de serveurs locale.
Cette commande définit une variable, $sssp, pour le proxy d’application de service que vous utilisez quand vous restaurez la phrase secrète.

Pour plus d'informations, voir New-SPSecureStoreServiceApplicationProxy.

Après avoir créé l'application de service Banque d'informations sécurisée et le proxy, vous devez actualiser la clé de chiffrement. Pour plus d'informations sur l'actualisation de la clé de chiffrement, voir Actualiser la clé de chiffrement de la banque d'informations sécurisée.
Tapez la commande suivante pour restaurer la phrase secrète pour l'application de service Banque d'informations sécurisée :
```
Update-SPSecureStoreApplicationServerKey -Passphrase <Passphrase> -ServiceApplicationProxy $sssp
```
Où :
- <Passphrase> est la phrase secrète qui était utilisée dans votre environnement précédent pour l'application de service Banque d'informations sécurisée.
- $sssp est une variable que vous avez définie précédemment pour identifier le nouveau proxy d'application de service Banque d'informations sécurisée.
  
  Conseil
  
  [!CONSEIL] Si vous n'utilisez pas de variable $sssp, vous devez identifier le proxy d'application de service Banque d'informations sécurisée avec un ID au lieu d'un nom. Pour rechercher cet ID, exécutez l'applet de commande Get-SPServiceApplicationProxy qui affiche la liste de tous les ID de proxy d'application de service.
Pour plus d'informations, voir Update-SPSecureStoreApplicationServerKey.

Mettre à niveau l'application de Service Business Data Connectivity

Pour mettre à niveau l’application de service Business Data Connectivity, vous créez l’application de service et mettez à niveau la base de données. Vous n'avez pas besoin de créer de proxy pour l'application du Service Business Data Connectivity. Lorsque vous créez l'application de service Service Business Data Connectivity, un proxy est automatiquement créé et ajouté au groupe de proxys par défaut.

Pour mettre à niveau l'application de Service Business Data Connectivity à l'aide de PowerShell

Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
  
  Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server 2019 ou SharePoint Server 2016.
  
  Notes
  
  [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Subscription Edition Management Shell.
Pour stocker le pool d'applications à utiliser en tant que variable pour cette application de service, à l'invite de commandes Microsoft PowerShell, tapez la commande suivante :
```
$applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
```
Où :
- SharePoint Web Services default est le nom du pool d'applications de service qui contiendra les nouvelles applications de service.
Cette applet de commande définit le pool d'applications de service en tant que variable réutilisable dans les applets de commande qui suivent. Si vous avez plusieurs pools d'applications et que vous devez utiliser un pool d'applications différent pour une application de service particulière, répétez cette étape dans la procédure pour créer chaque application de service afin d'utiliser le pool d'applications approprié.
Pour mettre à niveau l'application de Service Business Data Connectivity, à l'invite de commandes Microsoft PowerShell, tapez la commande suivante :
```
New-SPBusinessDataCatalogServiceApplication -Name 'BDC Service' -ApplicationPool $applicationPool -DatabaseName 'BDC_Service_DB'
```
Où :
- BDC Service est le nom que vous souhaitez donner à la nouvelle application de Service Business Data Connectivity.
- $applicationpool est la variable que vous avez définie précédemment pour identifier le pool d’applications de service à utiliser.
  
  Conseil
  
  [!CONSEIL] Si vous n'utilisez pas la variable $applicationPool, alors vous devez spécifier le nom d'un pool d'applications de service existant au format ' Application Pool Name'. Pour afficher la liste des pools d'applications de service, vous pouvez exécuter l'applet de commande Get-SPServiceApplicationPool.
- BDC_Service_DB est le nom de la base de données d'application de service que vous souhaitez mettre à niveau.
Pour plus d'informations, voir New-SPBusinessDataCatalogServiceApplication.

Mettre à niveau l’application de service de métadonnées gérées

Pour mettre à niveau l’application de service de métadonnées gérées, vous devez créer l’application de service et mettre à niveau la base de données associée, puis créer un proxy et l’ajouter au groupe de proxys par défaut.

Pour mettre à niveau l'application de service de métadonnées gérées à l'aide de PowerShell

Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
  
  Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server 2019 ou SharePoint Server 2016.
  
  Notes
  
  [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Subscription Edition Management Shell.
Pour stocker le pool d’applications que vous souhaitez utiliser comme variable pour cette application de service, à l’invite de commandes PowerShell, tapez la commande suivante :
```
$applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
```
Où :
- SharePoint Web Services default est le nom du pool d'applications de service qui contiendra les nouvelles applications de service.
Cette applet de commande définit le pool d'applications de service en tant que variable réutilisable dans les applets de commande qui suivent. Si vous avez plusieurs pools d'applications et que vous devez utiliser un pool d'applications différent pour une application de service particulière, répétez cette étape dans la procédure pour créer chaque application de service afin d'utiliser le pool d'applications approprié.
Pour mettre à niveau l’application de service de métadonnées managées, à l’invite de commandes PowerShell, tapez la commande suivante :
```
$mms = New-SPMetadataServiceApplication -Name 'Managed Metadata Service Application' -ApplicationPool $applicationPool -DatabaseName 'Managed Metadata Service_DB'
```
Où :
- Managed Metadata Service Application est le nom que vous souhaitez donner à la nouvelle application de service de métadonnées gérées.
- $applicationpool est la variable que vous avez définie précédemment pour identifier le pool d’applications de service à utiliser.
  
  Conseil
  
  [!CONSEIL] Si vous n'utilisez pas la variable $applicationPool, alors vous devez spécifier le nom d'un pool d'applications de service existant au format ' Application Pool Name'. Pour afficher la liste des pools d'applications de service, vous pouvez exécuter l'applet de commande Get-SPServiceApplicationPool.
- Managed Metadata Service_DB est le nom de la base de données d'application de service que vous souhaitez mettre à niveau.
  
  Cette commande définit une variable $mms que vous utiliserez plus tard lors de la création du proxy.
Pour plus d'informations, voir New-SPMetadataServiceApplication.
À l’invite de commandes PowerShell, tapez la commande suivante pour créer un proxy pour l’application de service de métadonnées managées :
```
New-SPMetadataServiceApplicationProxy -Name ProxyName -ServiceApplication $mms -DefaultProxyGroup
```
Où :
- ProxyName est le nom du proxy que vous souhaitez utiliser.
- $mms est la variable que vous avez définie précédemment pour identifier la nouvelle application de service de métadonnées gérées.
  
  Conseil
  
  [!CONSEIL] Si vous n'utilisez pas de variable $mms, vous devez identifier le proxy d'application de service Métadonnées gérées avec un ID au lieu d'un nom. Pour rechercher cet ID, exécutez l'applet de commande Get-SPServiceApplication qui affiche la liste de tous les ID d'application de service.
- DefaultProxyGroup ajoute le proxy d'application de service de métadonnées gérées au groupe de proxys par défaut pour la batterie de serveurs locale.
Pour plus d'informations, voir New-SPMetadataServiceApplicationProxy.

Mettre à niveau l’application de service de profil utilisateur

Mettez à niveau l’application de service de métadonnées managées avant de mettre à niveau l’application de service Profil utilisateur.

Pour mettre à niveau l’application de service Profil utilisateur, vous copiez les bases de données Profil et Réseaux sociaux de votre batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 vers votre batterie de serveurs SharePoint Server Édition d’abonnement et créez une application de service profil utilisateur à partir de votre batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 dans votre batterie de serveurs SharePoint Server Édition d’abonnement. La restauration déclenche SharePoint Server Édition d’abonnement pour créer une application de service profil utilisateur dans la batterie de serveurs SharePoint Server Édition d’abonnement et la pointer vers les bases de données de profil utilisateur copiées. Pour terminer la mise à niveau de l’application de service profil utilisateur, vous créez un proxy et l’ajoutez au groupe proxy par défaut.

Pour mettre à niveau l’application de service Profil utilisateur à l’aide de PowerShell

Copiez les bases de données Profil et Social de la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 vers la batterie de serveurs SharePoint Server Édition d’abonnement en procédant comme suit :

Importante

Effectuez ces étapes dans l’environnement SharePoint Server 2019 et SharePoint Server 2016.
- Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
  
  Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server 2019 ou SharePoint Server 2016.
  
  Notes
  
  [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
- Démarrez SharePoint Management Shell.
- Définissez les bases de données de profil utilisateur en lecture seule. Dans la deuxième phase du processus de mise à niveau des données et des sites SharePoint Server 2019 ou SharePoint Server 2016 vers SharePoint Server Édition d’abonnement, vous définissez toutes les autres bases de données en lecture seule.
- Copiez les bases de données Profil et Social de la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 vers la batterie de serveurs SharePoint Server Édition d’abonnement, suivez les procédures décrites dans Copier des bases de données vers la nouvelle batterie de serveurs pour la mise à niveau vers SharePoint Server Édition d’abonnement.
  
  Importante
  
  Effectuez les étapes suivantes dans l’environnement SharePoint Server Édition d’abonnement.
Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server 2019 ou SharePoint Server 2016.

Notes

[!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Subscription Edition Management Shell.
Pour stocker le pool d'applications à utiliser en tant que variable pour cette application de service, à l'invite de commandes Microsoft PowerShell, tapez la commande suivante :
```
$applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
```
Où :

SharePoint Web Services default est le nom du pool d'applications de service qui contiendra les nouvelles applications de service.

Cette applet de commande définit le pool d'applications de service en tant que variable réutilisable dans les applets de commande qui suivent. Si vous avez plusieurs pools d'applications et que vous devez utiliser un pool d'applications différent pour une application de service particulière, répétez cette étape dans la procédure pour créer chaque application de service afin d'utiliser le pool d'applications approprié.
Pour restaurer l’application de service Profil utilisateur et mettre à niveau les bases de données Profil et Social, à l’invite de commandes Microsoft PowerShell, tapez la commande suivante :
```
New-SPProfileServiceApplication -Name '<UserProfileApplicationName>' -ApplicationPool $applicationPool -ProfileDBName '<ProfileDBName>' -SocialDBName '<SocialDBName>' -ProfileSyncDBName '<SyncDBName>'
```
Où :
- UserProfileApplicationName est le nom de l’application de service Profil utilisateur.
- $applicationpool est la variable que vous avez définie pour identifier le pool d’applications de service à utiliser.
  
  Notes
  
  Si vous n’utilisez pas la variable $applicationPool, vous devez spécifier le nom d’un pool d’applications de service existant au format « Nom du pool d’applications ». Pour afficher la liste des pools d'applications de service, exécutez la cmdlet Get-SPServiceApplicationPool.
- ProfileDBName est le nom de la base de données de profil que vous souhaitez mettre à niveau.
- SocialDBName est le nom de la base de données sociale que vous souhaitez mettre à niveau.
- SyncDBName est le nom de la nouvelle base de données de synchronisation.
Créez le proxy d’application de service Profil utilisateur et ajoutez-le au groupe proxy par défaut en effectuant les actions suivantes :
- Tapez la commande suivante pour obtenir l’ID de l’application de service Profil utilisateur et le stocker en tant que variable :
```
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'User Profile Service Application'}
```
  Pour plus d'informations, voir Get-SPServiceApplication.
- Tapez la commande suivante pour créer un proxy pour l’application de service Profil utilisateur :
```
New-SPProfileServiceApplicationProxy -Name 'User Profile Service Application Proxy' -ServiceApplication $sa
```
  Où :
  - ProxyName est le nom du proxy que vous souhaitez utiliser.
  - $sa est la variable que vous avez définie précédemment pour identifier la nouvelle application de service Profil utilisateur.
    
    Conseil
    
    Si vous n’utilisez pas la variable $sa, vous devez utiliser un ID pour identifier l’application de service profil utilisateur au lieu d’un nom. Pour rechercher cet ID, exécutez la cmdlet Get-SPServiceApplication qui affiche la liste de tous les ID d'application de service.
  Pour plus d’informations, consultez New-SPProfileServiceApplicationProxy.
- Tapez la commande suivante pour obtenir l’ID de proxy d’application du service Profil utilisateur pour le proxy que vous venez de créer et définissez-le comme variable $proxy :
```
$proxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq 'User Profile Service Application Proxy'}
```
  Pour plus d’informations, voir Get-SPServiceApplicationProxy.
- Tapez la commande suivante pour ajouter le proxy d’application de service Profil utilisateur au groupe de proxys par défaut :
```
Add-SPServiceApplicationProxyGroupMember -member $proxy -identity ""
```
  Où :
  - $proxy est la variable que vous avez définie précédemment pour identifier l’ID du proxy que vous venez de créer pour l’application de service Profil utilisateur.
    
    Conseil : Si vous n’utilisez pas la variable $proxy, vous devez utiliser un ID pour identifier le proxy d’application de service profil utilisateur au lieu d’un nom. Pour rechercher cet ID, exécutez la cmdlet Get-SPServiceApplicationProxy qui affiche la liste de tous les ID de proxy d'application de service.
  - Vous utilisez un paramètre Identity vide (« ») pour l’ajouter au groupe par défaut.
  Pour plus d'informations, voir Add-SPServiceApplicationProxyGroupMember.

Mettre à niveau l’application de service de recherche

Mettez à niveau l’application de service Profil utilisateur et l’application de service de métadonnées gérées pour pouvoir mettre à niveau l’application de service de recherche.

Pour mettre à niveau l’application de service De recherche, vous copiez la base de données d’administration de la recherche de votre batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 vers votre batterie de serveurs SharePoint Server Édition d’abonnement et restaurez l’application de service de recherche à partir de votre batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 dans votre batterie de serveurs SharePoint Server Édition d’abonnement. La restauration déclenche SharePoint Server Édition d’abonnement pour créer une application de service de recherche dans la batterie de serveurs SharePoint Server Édition d’abonnement et la pointer vers la base de données d’administration de recherche copiée. Pour terminer la mise à niveau de l’application de service de recherche, vous créez un proxy et l’ajoutez au groupe de proxys par défaut, et vous assurez que la nouvelle base de données de liens et la nouvelle topologie de recherche sont configurées de la même façon que dans la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016.

SharePoint Server Édition d’abonnement crée normalement une topologie de recherche avec tous les composants et bases de données de recherche lorsqu’il crée une application de service de recherche. Lors d’une restauration d’une application de service de recherche, SharePoint Server Édition d’abonnement crée une nouvelle topologie de recherche, mais met à niveau la base de données d’administration de la recherche restaurée au lieu de créer une base de données d’administration de recherche. La base de données d’administration de la recherche mise à niveau conserve tous les ajouts ou modifications apportés au schéma de recherche, aux sources de résultats et aux règles de requête de la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016.

Notes

Pendant cette mise à niveau, la recherche n’analyse pas le contenu dans sharePoint Server 2019 ou SharePoint Server 2016. Si l'actualisation des résultats de recherche est importante, gagnez du temps en vous familiarisant avec ces étapes avant de commencer la mise à niveau.

Importante

Comme la topologie de recherche dans la batterie de serveurs SharePoint Server Édition d’abonnement est nouvelle, l’index est vide. Vous devez effectuer une analyse complète de l’ensemble du corpus indexé après avoir mis à niveau toutes les sources de contenu (la quatrième phase du processus de mise à niveau des données et des sites SharePoint Server 2019 et SharePoint Server 2016 vers SharePoint Server Édition d’abonnement).

Pour mettre à niveau l'application de service de recherche à l'aide de PowerShell

Copiez la base de données d’administration de la recherche dans la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 vers la batterie de serveurs SharePoint Server Édition d’abonnement et procédez comme suit :

Notes

Vous avez copié toutes les autres bases de données de contenu et de service dans votre environnement SharePoint Server 2019 ou SharePoint Server 2016 dans une étape antérieure du processus de mise à niveau vers SharePoint Server Édition d’abonnement. Nous vous recommandons de copier la base de données d’administration de la recherche à cette étape ultérieure, car vous devez suspendre l’application de service de recherche dans votre environnement SharePoint Server 2019 ou SharePoint Server 2016 lors de la copie de la base de données d’administration de la recherche.

Importante

Effectuez ces étapes dans l’environnement SharePoint Server 2019 ou SharePoint Server 2016.
- Vérifiez que vous êtes membre :
  - du rôle serveur fixe securityadmin sur l'instance SQL Server.
  - du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
  - du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
    
    Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server Édition d’abonnement.
    
    Notes
    
    [!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
- Démarrez SharePoint 2019 ou SharePoint 2016 Management Shell.
- Suspendez l'application Service de recherche. À partir de l’invite de commandes PowerShell, entrez la commande suivante :
```
  $ssa = Get-SPEnterpriseSearchServiceApplication <SearchServiceApplicationName>
  Suspend-SPEnterpriseSearchServiceApplication -Identity $ssa
```
  Où :
  
  SearchServiceApplicationName est le nom de l'application de service de recherche à suspendre.
  
  Notes
  
  Pendant que l’application de service de recherche est suspendue, l’index dans l’environnement SharePoint Server 2019 ou SharePoint Server 2016 n’est pas mis à jour. Cela signifie que pendant la mise à niveau vers SharePoint Server Édition d’abonnement, les résultats de la recherche peuvent être moins actualisés.
- Définissez la base de données des paramètres de recherche en mode lecture seule. Dans la deuxième phase du processus de mise à niveau des données et des sites SharePoint Server 2019 ou SharePoint Server 2016 vers SharePoint Server Édition d’abonnement, vous définissez toutes les autres bases de données en lecture seule. Suivez maintenant les mêmes instructions pour la base de données des paramètres de recherche.
- Copiez la base de données d’administration de la recherche dans la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 vers la batterie de serveurs SharePoint Server Édition d’abonnement. Suivez les procédures décrites dans Copier des bases de données vers la nouvelle batterie de serveurs pour la mise à niveau vers SharePoint Server Subscription Edition pour la base de données d’administration de la recherche uniquement.
  
  Importante
  
  Effectuez les étapes suivantes dans l’environnement SharePoint Server Édition d’abonnement.
Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server Édition d’abonnement.

Notes

[!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Subscription Edition Management Shell.
Pour stocker le pool d’applications que vous souhaitez utiliser comme variable pour cette application de service, à l’invite de commandes PowerShell, tapez la commande suivante :
```
$applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
```
Où :

SharePoint Web Services default est le nom du pool d'applications de service qui contiendra les nouvelles applications de service.

Cette applet de commande définit le pool d'applications de service en tant que variable réutilisable dans les applets de commande qui suivent. Si vous avez plusieurs pools d'applications et que vous devez utiliser un pool d'applications différent pour une application de service particulière, répétez cette étape dans la procédure pour créer chaque application de service afin d'utiliser le pool d'applications approprié.
Pour restaurer l’application de service de recherche et mettre à niveau la base de données d’administration de la recherche, à l’invite de commandes PowerShell, tapez la commande suivante :
```
$searchInst = Get-SPEnterpriseSearchServiceInstance -local
# Gets the Search service instance and sets a variable to use in the next command
Restore-SPEnterpriseSearchServiceApplication -Name '<SearchServiceApplicationName>' -applicationpool $applicationPool -databasename '<SearchServiceApplicationDBName>' -databaseserver <ServerName> -AdminSearchServiceInstance $searchInst 
```
Où :
- SearchServiceApplicationName est le nom de l'application de service de recherche.
- $applicationpool est la variable que vous avez définie pour identifier le pool d’applications de service à utiliser.
  
  Notes
  
  [!CONSEIL] Si vous n'utilisez pas la variable $applicationPool, alors vous devez spécifier le nom d'un pool d'applications de service existant au format ' Application Pool Name'. Pour afficher la liste des pools d'applications de service, exécutez la cmdlet Get-SPServiceApplicationPool.
- SearchServiceApplicationDBName est le nom de la base de données des paramètres de recherche que vous voulez mettre à niveau et que l'application de service de recherche doit utiliser.
- $searchInst est la variable que vous avez définie précédemment pour identifier la nouvelle instance d’application de service de recherche.
  Notes
  
  Une mise à niveau d’une application de service de recherche peut échouer, par exemple en raison de la latence du réseau ou de SQL Server. Si un message d'erreur s'affiche pendant la mise à niveau, procédez comme suit :
  - Supprimez la base de données d’administration de recherche que vous étiez en train de mettre à niveau.
  - En utilisant votre copie de sauvegarde de la base de données d’administration de la recherche, répétez les procédures suivantes de cet article uniquement pour l’application de service de recherche :
    - Restaurer une copie de sauvegarde de la base de données
    - Définir les bases de données en lecture/écriture
  - Tapez à nouveau la commande pour mettre à niveau l’application de service de recherche à l’invite de commandes PowerShell.
Pour plus d'informations, voir Restore-SPEnterpriseSearchServiceApplication.
Créez le proxy d’application de service de recherche et ajoutez-le au groupe de proxys par défaut en effectuant les actions suivantes :
- Pour obtenir l’ID de l’application de service de recherche et le stocker en tant que variable, tapez la commande suivante :
```
$ssa = Get-SPEnterpriseSearchServiceApplication
```
  Pour plus d'informations, voir Get-SPEnterpriseSearchServiceApplication.
- Pour créer un proxy pour l’application de service de recherche, tapez la commande suivante :
```
New-SPEnterpriseSearchServiceApplicationProxy -Name ProxyName -SearchApplication $ssa 
```
  Où :
  - ProxyName est le nom du proxy que vous souhaitez utiliser.
  - $ssa est la variable que vous avez définie précédemment pour identifier la nouvelle application de service de recherche.
    
    Conseil
    
    Si vous n’utilisez pas la variable $ssa, vous devez utiliser un ID pour identifier l’application de service de recherche au lieu d’un nom. Pour rechercher cet ID, exécutez la cmdlet Get-SPServiceApplication qui affiche la liste de tous les ID d'application de service.
  Pour plus d'informations, voir New-SPEnterpriseSearchServiceApplicationProxy.
- Pour obtenir l’ID du nouveau proxy créé pour l’application de service de recherche et le stocker en tant que variable $ssap, tapez la commande suivante :
```
$ssap = Get-SPEnterpriseSearchServiceApplicationProxy 
```
  Pour plus d'informations, voir Get-SPEnterpriseSearchServiceApplicationProxy.
- Pour ajouter le proxy de l’application de service de recherche au groupe de proxys par défaut, tapez la commande suivante :
```
Add-SPServiceApplicationProxyGroupMember -member $ssap -identity ""
```
  Où :
  - $ssa est la variable que vous avez définie précédemment pour identifier l’ID du nouveau proxy créé pour l’application de service de recherche.
    
    Conseil
    
    Si vous n’utilisez pas la variable $ssap, vous devez utiliser un ID pour identifier le proxy d’application de service de recherche au lieu d’un nom. Pour rechercher cet ID, exécutez la cmdlet Get-SPServiceApplicationProxy qui affiche la liste de tous les ID de proxy d'application de service.
  - Vous utilisez un paramètre Identity vide (« ») pour l’ajouter au groupe par défaut.
  Pour plus d'informations, voir Add-SPServiceApplicationProxyGroupMember.
Si la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 utilise une base de données de liens partitionnée, partitionnez la base de données de liens dans la batterie de serveurs SharePoint Server Édition d’abonnement de la même façon. Pour plus d'informations, consultez la rubrique Move-SPEnterpriseSearchLinksDatabases.
(Facultatif) Conservez les paramètres de pertinence de recherche de la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016. Étant donné que l’application de service de recherche mise à niveau a un nouvel index vide, les données d’analyse de recherche de la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 ne peuvent pas être entièrement conservées. Copiez la base de données de rapports analytiques à partir de la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016 et attachez-la à la nouvelle application de service de recherche dans la batterie de serveurs SharePoint Server Édition d’abonnement :
- Dans la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016, sauvegardez la base de données de rapports d’analyse.
- Dans la batterie de serveurs SharePoint Server Édition d’abonnement, restaurez la base de données sauvegardée sur le nouveau serveur de base de données.
- Dans la batterie de serveurs SharePoint Server Édition d’abonnement, attachez la base de données restaurée à la nouvelle application de service de recherche.
Vérifiez que la topologie de recherche sur la nouvelle batterie de serveurs SharePoint Server Édition d’abonnement est semblable à celle de la batterie de serveurs SharePoint Server 2019 ou SharePoint Server 2016. Si vos besoins en matière de recherche ont changé, le moment est venu d’effectuer un scale-out de la topologie de recherche de la nouvelle batterie de serveurs SharePoint Server Édition d’abonnement.
Reprenez l’application de service de recherche dans l’environnement SharePoint Server.

À partir de l’invite de commandes PowerShell, entrez la commande suivante :
```
$ssa = Get-SPEnterpriseSearchServiceApplication <SearchServiceApplicationName>
$ssa.ForceResume(0x02)
```
Où :
- SearchServiceApplicationName est le nom de l'application de service de recherche que vous souhaitez relancer.

Vérifier que tous les nouveaux proxys sont dans le groupe de proxys par défaut

En suivant la procédure ci-dessous, vérifiez que les proxys ont bien été créés et ajoutés au groupe de proxys par défaut.

Pour vérifier que tous les nouveaux proxys figurent dans le groupe de proxys par défaut à l'aide de PowerShell

Vérifiez que vous êtes membre :
- du rôle serveur fixe securityadmin sur l'instance SQL Server.
- du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;
- du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.
Un administrateur peut utiliser l’applet de commande Add-SPShellAdmin pour accorder des autorisations d’utilisation des applets de commande SharePoint Server 2019 ou SharePoint Server 2016.

Notes

[!REMARQUE] Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.
Démarrez SharePoint Subscription Edition Management Shell.
À l'invite de commandes PowerShell, tapez les commandes suivantes :
```
$pg = Get-SPServiceApplicationProxyGroup -Identity ""
$pg.Proxies
```
Où :
- $pg est la variable que vous définissez pour représenter le groupe de proxys par défaut.
- Vous utilisez un paramètre Identity vide (« ») pour spécifier le groupe de proxys par défaut.
Cette commande renvoie une liste de tous les proxys figurant dans le groupe de proxys par défaut, avec leurs noms complets, leurs noms de types et leurs ID.

Pour plus d’informations, consultez Get-SPServiceApplicationProxyGroupGet-SPServiceApplicationProxyGroup.

Une fois que les applications de service ont été mises à niveau, vous pouvez procéder à la mise à niveau des bases de données de contenu. La première étape de ce processus consiste à créer les applications web nécessaires pour chaque base de données de contenu.

Phases	Description
	Il s’agit de la troisième phase du processus de mise à niveau des données et des sites SharePoint Server 2019 et SharePoint Server 2016 vers SharePoint Server Édition d’abonnement. Pour obtenir une vue d’ensemble de l’ensemble du processus, voir Vue d’ensemble du processus de mise à niveau vers SharePoint Server Édition d’abonnement.