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.

This cmdlet is intended only to be used with a database that uses Windows authentication. There is no need to use this cmdlet for databases that use SQL authentication; in fact, doing so may result in an error message.

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.

--If you use the database parameter, the user is added to the role on the farm configuration database, the Central Administration content database, and the specified database. Using the database parameter is the preferred method because most of the administrative operations require access to the Central Administration content database.

The user is added to the WSS_Admin_WPG group on all Web servers when the user is added to the SharePoint_Shell_Access role. If the target database does not have a SharePoint_Shell_Access role, the role is automatically created.

Pour 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 WSS_ADMIN_WPG local 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 connaître les autorisations et les informations les plus récentes concernant Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne 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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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

-Base de données

Specifies the GUID of the database or the Database object that includes the SharePoint_Shell_Access role to which you want to add the user. If the database parameter is not specified, the configuration database is used. The farm configuration database is always included, even if you specify another database.

Type:SPDatabasePipeBind
Position:Named
Default value:None
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
Accept pipeline input:False
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

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