Add-SPShellAdmin
Fügt der SharePoint_Shell_Access-Rolle für die angegebene Datenbank einen Benutzer hinzu.
Syntax
Default (Standardwert)
Add-SPShellAdmin
[-UserName] <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-database <SPDatabasePipeBind>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Wenn Sie dieses Cmdlet ausführen, um der rolle "SharePoint_Shell_Access" einen Benutzer hinzuzufügen, müssen Sie über die Mitgliedschaft in der festen Serverrolle securityadmin auf dem SQL Server instance, die Mitgliedschaft in der festen Datenbankrolle db_owner für alle betroffenen Datenbanken und die lokale Administratorberechtigung auf dem lokalen Computer verfügen.
Dieses Cmdlet ist nur für die Verwendung mit einer Datenbank vorgesehen, die Windows-Authentifizierung verwendet. Es ist nicht erforderlich, dieses Cmdlet für Datenbanken zu verwenden, die die SQL-Authentifizierung verwenden. dies kann zu einer Fehlermeldung führen.
Verwenden Sie das Cmdlet Add-SPShellAdmin, um der Rolle SharePoint_Shell_Access wie folgt einen Benutzer hinzuzufügen:
Wenn Sie nur den Benutzer angeben, wird der Benutzer der Rolle für die Farmkonfigurationsdatenbank hinzugefügt.
--Wenn Sie den Datenbankparameter verwenden, wird der Benutzer der Rolle für die Farmkonfigurationsdatenbank, der Inhaltsdatenbank der Zentraladministration und der angegebenen Datenbank hinzugefügt. Die Verwendung des Datenbankparameters ist die bevorzugte Methode, da die meisten Verwaltungsvorgänge Zugriff auf die Inhaltsdatenbank der Zentraladministration erfordern.
Der Benutzer wird der gruppe WSS_Admin_WPG auf allen Webservern hinzugefügt, wenn der Benutzer der rolle SharePoint_Shell_Access 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 verwenden zu können, muss ein Benutzer Mitglied der rolle SharePoint_Shell_Access in der Konfigurationsdatenbank und Mitglied der lokalen gruppe WSS_ADMIN_WPG auf dem Computer sein, auf dem SharePoint-Produkte installiert ist.
Das Ergebnis der Ausführung dieses Cmdlets ist jedoch, dass der mit dem UserName-Parameter angegebene Benutzer die SPDataAccess-Rolle (sofern vorhanden) oder db_owner Rolle (falls die SPDataAccess-Rolle nicht vorhanden ist) für die betroffenen Datenbanken wie oben beschrieben erhält. Daher sollten Sie sorgfältig planen, welche Benutzer diesen Zugriff erhalten.
Daher sollten Sie sorgfältig planen, welche Benutzer diesen Zugriff erhalten.
Berechtigungen und aktuelle Informationen zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter https://go.microsoft.com/fwlink/p/?LinkId=251831.
Beispiele
BEISPIEL 1
Add-SPShellAdmin -UserName CONTOSO\User1
In diesem Beispiel wird nur der SharePoint_Shell_Access Rolle in der Farmkonfigurationsdatenbank ein neuer Benutzer mit dem Namen User1 hinzugefügt. Außerdem wird sichergestellt, dass der Benutzer der WSS_Admin_WPG lokalen Gruppe 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 sowohl in der angegebenen Inhaltsdatenbank als auch in der Konfigurationsdatenbank ein neuer Benutzer mit dem Namen User1 hinzugefügt, indem eine Datenbank-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 sowohl in der angegebenen Inhaltsdatenbank der Zentraladministration als auch 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.
Parameter
-AssignmentCollection
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SPAssignmentCollection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-database
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SPDatabasePipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserName
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt den Namen des Benutzers an, der der Rolle SharePoint_Shell_Access in der Zieldatenbank hinzugefügt werden soll.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.