Partager via

Cmdlets SharePoint Server

  • Article

Pour obtenir la liste des cmdlets SharePoint Server, consultezCmdlets SharePoint Server

Accès à PowerShell pour SharePoint Server

Une fois que vous avez installé SharePoint Server, les cmdlets PowerShell applicables sont disponibles dans SharePoint 2016 Management Shell. Vous pouvez gérer la plupart des aspects de SharePoint Server dans SharePoint Management Shell. Vous pouvez créer des collections de sites, des applications web, des comptes d'utilisateur, des applications de service, des proxys, et bien d'autres choses encore. Les commandes que vous tapez dans SharePoint Management Shell retournent des objets SharePoint qui sont fondés sur Microsoft .NET Framework. Ces objets peuvent être appliqués comme entrées de commandes ultérieures ou stockés dans des variables locales pour une utilisation ultérieure.

Avec SharePoint Management Shell, vous ne devez pas inscrire le composant logiciel enfichable qui contient les applets de commande. L’inscription du module Microsoft.SharePoint.PowerShell.dll pour les applets de commande SharePoint Server est automatique, suite à la Microsoft Add-PSSnapin. Ligne SharePoint.PowerShell dans le fichier SharePoint.ps1 qui se trouve dans %CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration, où la version « 15 » est égale à SharePoint Server 2013 et la version « 16 » est égale à SharePoint Server 2016. Pour utiliser la console PowerShell, vous devez inscrire manuellement ce composant logiciel enfichable.

Que vous utilisiez SharePoint Management Shell ou la console PowerShell, vous pouvez également charger des composants logiciels enfichables supplémentaires.

Remarque

SharePoint Management Shell et la console PowerShell diffèrent également sur l’utilisation de l’option ReuseThread, qui définit l’utilisation du modèle de thread. L’utilisation de SharePoint Management Shell est définie sur cette ligne, {Host.Runspace.ThreadOptions = "ReuseThread"}, qui se trouve dans le fichier SharePoint.ps1. Pour plus d’informations, consultez Options PS Thread.

Autorisations

Avant de pouvoir utiliser l'applet de commande Add-SPShellAdmin pour accorder des autorisations aux utilisateurs afin d'exécuter des applets de commande SharePoint Server, vérifiez que vous respectez tous les critères de configuration minimale suivants :

  • vous devez être membre du rôle serveur fixe securityadmin sur l'instance SQL Server.
  • vous devez être membre du groupe Administrateurs sur le serveur sur lequel vous exécutez l'applet de commande PowerShell.

Remarque

Si vous ne disposez pas de ces autorisations, faites-en la demande auprès de votre administrateur de configuration ou administrateur SQL Server.

Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

Si vous n'êtes pas membre du rôle SharePoint_Shell_Access ou du groupe local WSS_Admin_WPG, utilisez l'applet de commande Add-SPShellAdmin pour ajouter le groupe WSS_Admin_WPG dans tous les serveurs web frontaux de la batterie de serveurs SharePoint et le rôle SharePoint_Shell_Access. Si la base de données SQL Server ne dispose pas d'un rôle SharePoint_Shell_Access, celui-ci est automatiquement créé lorsque vous exécutez l'applet de commande Add-SPShellAdmin. Après avoir exécuté l'applet de commande Add-SPShellAdmin, les utilisateurs peuvent exécuter les applets de commande PowerShell SharePoint dans un environnement de batterie de plusieurs serveurs.

Remarque

Lorsque vous installez SharePoint Server, le compte d'utilisateur à partir duquel vous exécutez l'installation se voit accorder les autorisations appropriées pour exécuter les applets de commande PowerShell. Si aucun utilisateur n'a été ajouté pour exécuter une applet de commande PowerShell, vous pouvez utiliser l'applet de commande Add-SPShellAdmin pour l'ajouter.

Pour obtenir la liste de toutes les cmdlets SPShellAdmin, à partir d’une invite de commandes PowerShell, tapez Get-Command -Noun SPShellAdmin.

Scripts et stratégies d’exécution

Bien que vous puissiez utiliser Microsoft PowerShell pour effectuer une tâche administrative unique, vous pouvez également recourir à un script pour automatiser une série de tâches. Un script est un fichier texte qui contient une ou plusieurs commandes Microsoft PowerShell. Les noms de scripts Microsoft PowerShell sont constitués de l'extension .ps1.

Pour exécuter des scripts, la stratégie d'exécution minimale requise pour SharePoint Server est RemoteSigned, bien que la stratégie par défaut pour PowerShell soit Restricted. Si la stratégie demeure Restricted, SharePoint Management Shell définira la stratégie pour PowerShell sur RemoteSigned. Cela signifie que vous devez sélectionner Exécuter en tant qu'administrateur pour démarrer SharePoint Management Shell avec une autorisation administrative élevée. Cette modification s'appliquera à toutes les sessions PowerShell. Pour plus d’informations, consultezénumération ExecutionPolicy.

Pour obtenir plus d'informations sur les scripts et les stratégies d'exécution, consultez about_scripts etÀ propos de stratégies d’exécution.