Add-SPShellAdmin

Fügt der SharePoint_Shell_Access-Rolle für die angegebene Datenbank einen Benutzer hinzu.

Syntax

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

Description

Wenn Sie dieses Cmdlet zum Hinzufügen eines Benutzers zur Rolle SharePoint_Shell_Access ausführen, müssen Sie Mitglied der festen Serverrolle securityadmin in der SQL Server Instanz, Mitgliedschaft in der festen Datenbankrolle db_owner für alle betroffenen Datenbanken und lokale administrative Berechtigung auf dem lokalen Computer.

Dieses Cmdlet ist nur für die Verwendung mit einer Datenbank vorgesehen, die die Windows-Authentifizierung verwendet. Es ist nicht erforderlich, dieses Cmdlet für Datenbanken zu verwenden, die die SQL-Authentifizierung verwenden. in der Tat kann dies dazu führen, dass eine Fehlermeldung angezeigt wird.

Verwenden Sie das Cmdlet Add-SPShellAdmin, um einen Benutzer wie folgt zur Rolle SharePoint_Shell_Access hinzuzufügen:

  • Wenn Sie nur den Benutzer angeben, wird der Benutzer der Rolle für die Farmkonfigurationsdatenbank hinzugefügt.

--Wenn Sie den Parameter Database verwenden, wird der Benutzer der Rolle in der Farmkonfigurationsdatenbank, der Inhaltsdatenbank der zentral Administration und der angegebenen Datenbank hinzugefügt. Die Verwendung des Database-Parameters ist die bevorzugte Methode, da der Großteil der administrativen Vorgänge Zugriff auf die Inhaltsdatenbank der zentral Administration benötigt.

Der Benutzer wird der Gruppe WSS_ADMIN_WPG auf allen Webservern hinzugefügt, wenn der Benutzer der SharePoint_Shell_Access-Rolle hinzugefügt wird. Wenn die Zieldatenbank nicht über eine SharePoint_Shell_Access-Rolle verfügt, wird die Rolle automatisch erstellt.

Um Windows PowerShell für SharePoint-Produkte zu verwenden, muss ein Benutzer ein Mitglied der SharePoint_Shell_Access-Rolle in der Konfigurationsdatenbank und ein Mitglied der lokalen WSS_ADMIN_WPG-Gruppe auf dem Computer sein, auf dem SharePoint-Produkte installiert sind.

Das Ergebnis der Ausführung dieses Cmdlets besteht jedoch darin, dass der Benutzer, der mit dem Parameter username angegeben ist, über die SPDataAccess -Rolle (sofern vorhanden) oder die Rolle db_owner verfügt, sofern die SPDataAccess-Rolle nicht vorhanden ist, wie oben beschrieben. Daher sollten Sie sorgfältig planen, welche Benutzer diesen Zugriff erhalten.

Daher sollten Sie sorgfältig planen, welche Benutzer diesen Zugriff erhalten.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint Online finden Sie in der Onlinedokumentation unter https://go.microsoft.com/fwlink/p/?LinkId=251831.

Examples

------------BEISPIEL 1----------------

Add-SPShellAdmin -UserName CONTOSO\User1

In diesem Beispiel wird der SharePoint_Shell_Access-Rolle in der Farmkonfigurationsdatenbank nur ein neuer Benutzer mit dem Namen "user1" hinzugefügt, und es wird sichergestellt, dass der Benutzer der lokalen Gruppe WSS_ADMIN_WPG auf jedem Server in der Farm hinzugefügt wird.

-------------------Beispiel 2-------------------------

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

In diesem Beispiel wird der SharePoint_Shell_Access-Rolle in der angegebenen Inhaltsdatenbank und in der Konfigurationsdatenbank ein neuer Benutzer mit dem Namen "user1" hinzugefügt, indem eine Daten Bank GUID an das Cmdlet übergeben wird.

-------------------Beispiel 3-------------------------

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

In diesem Beispiel wird der SharePoint_Shell_Access-Rolle in der angegebenen Inhaltsdatenbank der zentral Administration und in der Konfigurationsdatenbank ein neuer Benutzer mit dem Namen "user1" hinzugefügt.

-------------------Beispiel 4-------------------------

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

In diesem Beispiel wird der Rolle SharePoint_Shell_Access in der angegebenen Inhaltsdatenbank und in der Konfigurationsdatenbank der neue BenutzerUser1 hinzugefügt. Dabei wird dem Cmdlet der Name der Datenbank übergeben.

Parameters

-Assignmentcollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Bestätigen

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Datenbank

Gibt die GUID der Datenbank oder des Database-Objekts an, die die SharePoint_Shell_Access-Rolle enthält, der Sie den Benutzer hinzufügen möchten. Wenn der Parameter database nicht angegeben wird, wird die Konfigurationsdatenbank verwendet. Die Farmkonfigurationsdatenbank ist immer enthalten, auch wenn Sie eine andere Datenbank angeben.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-UserName

Gibt den Namen des Benutzers an, der der Rolle SharePoint_Shell_Access in der Zieldatenbank hinzugefügt werden soll.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019