Partager via


Add-SPShellAdmin

Ajoute un utilisateur au rôle SharePoint_Shell_Access pour la base de données spécifiée.

Syntax

Add-SPShellAdmin
   [-UserName] <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Database <SPDatabasePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

Lorsque vous exécutez cette applet de commande pour ajouter un utilisateur au rôle SharePoint_Shell_Access, vous devez être membre du rôle serveur fixe securityadmin sur l’instance de SQL Server, être membre du rôle de base de données fixe db_owner sur toutes les bases de données affectées et disposer d’autorisations d’administration locales sur l’ordinateur local.

Cette applet de commande ne doit être employée qu’avec une base de données qui utilise l’authentification Windows. Il n’est pas nécessaire de recourir à cette applet de commande pour les bases de données qui utilisent l’authentification SQL, car vous risquez de recevoir un message d’erreur.

Utilisez l’applet de commande Add-SPShellAdmin pour ajouter un utilisateur au rôle SharePoint_Shell_Access comme suit :

--Si vous spécifiez uniquement l’utilisateur, ce dernier est ajouté au rôle de la base de données de configuration de batterie de serveurs.

--Si vous employez le paramètre database, l’utilisateur est ajouté au rôle de la base de données de configuration de batterie de serveurs, de la base de données de contenu de l’Administration centrale et de la base de données spécifiée. L’utilisation du paramètre database est la méthode recommandée, car la plupart des opérations d’administration requièrent l’accès à la base de données de contenu de l’Administration centrale.

L’utilisateur est ajouté au groupe WSS_Admin_WPG sur tous les serveurs web lorsque l’utilisateur est ajouté au rôle SharePoint_Shell_Access. Si la base de données cible ne comporte aucun rôle SharePoint_Shell_Access, ce dernier est automatiquement créé.

Pour pouvoir utiliser Windows PowerShell pour les produits SharePoint, un utilisateur doit être membre du rôle SharePoint_Shell_Access sur la base de données de configuration et membre du groupe local WSS_ADMIN_WPG sur l’ordinateur sur lequel les produits SharePoint sont installés.

Toutefois, le résultat de l’exécution de cette applet de commande est que l’utilisateur spécifié avec le paramètre UserName aura le rôle SPDataAccess , s’il existe, ou db_owner rôle, si le rôle SPDataAccess n’existe pas, sur les bases de données affectées, comme décrit ci-dessus. Par conséquent, nous vous recommandons de déterminer soigneusement quels sont les utilisateurs pouvant recevoir cet accès.

Par conséquent, nous vous recommandons de déterminer soigneusement quels sont les utilisateurs pouvant recevoir cet accès.

Pour obtenir les autorisations et les informations les plus actuelles sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne à l’adresse https://go.microsoft.com/fwlink/p/?LinkId=251831.

Exemples

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

Add-SPShellAdmin -UserName CONTOSO\User1

Cet exemple ajoute un nouvel utilisateur appelé User1 au rôle SharePoint_Shell_Access dans la base de données de configuration de la batterie de serveurs uniquement et garantit l’ajout de l’utilisateur au groupe local WSS_Admin_WPG sur chaque serveur de la batterie de serveurs.

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

Add-SPShellAdmin -UserName CONTOSO\User1 -database 4251d855-3c15-4501-8dd1-98f960359fa6

Cet exemple ajoute un nouvel utilisateur appelé User1 au rôle SharePoint_Shell_Access dans la base de données de contenu et dans la base de données de configuration spécifiées en transmettant un GUID de base de données à l’applet de commande.

-------------------EXEMPLE 3-------------------------

Get-SPDatabase | Where-Object {$_.WebApplication -like "SPAdministrationWebApplication"} | Add-SPShellAdmin CONTOSO\User1

Cet exemple ajoute un nouvel utilisateur appelé User1 au rôle SharePoint_Shell_Access dans la base de données de contenu Administration centrale spécifiée et la base de données de configuration.

-------------------EXEMPLE 4-------------------------

Get-SPDatabase | ?{$_.Name -eq "WSS_Content"} | Add-SPShellAdmin -Username CONTOSO\User1

Cet exemple ajoute un nouvel utilisateur appelé User1 au rôle SharePoint_Shell_Access dans la base de données de contenu et dans la base de données de configuration spécifiées en transmettant le nom de la base de données à l'applet de commande.

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 Subscription Edition

-Confirm

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Database

Spécifie le GUID de la base de données ou de l'objet Database qui inclut le rôle SharePoint_Shell_Access auquel vous voulez ajouter l'utilisateur. Si le paramètre database n'est pas spécifié, la base de données de configuration est utilisée. La base de données de configuration de la batterie de serveurs est toujours incluse, même si vous spécifiez une autre base de données.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UserName

Spécifie le nom de l'utilisateur à ajouter au rôle SharePoint_Shell_Access dans la base de données cible.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition