SharePoint Server-Cmdlets

Eine Liste der SharePoint Server-Cmdlets finden Sie unter SharePoint Server-Cmdlets.

Zugreifen auf PowerShell für SharePoint Server

Nach der Installation von SharePoint Server stehen Ihnen entsprechende PowerShell-Cmdlets in der SharePoint 2016-Verwaltungsshell zur Verfügung. Sie können die meisten Aspekte von SharePoint Server in der SharePoint 15-Verwaltungsshell verwalten. Sie können neue Websitesammlungen, Webanwendungen, Benutzerkonten, Dienstanwendungen, Proxys und viele andere Elemente erstellen. Befehle, die Sie in der SharePoint-Verwaltungsshell eingeben, geben SharePoint-Objekte zurück, die auf Microsoft .NET Framework basieren. Sie können diese Objekte als Eingabe für nachfolgende Befehle übernehmen oder die Objekte in lokalen Variablen zur späteren Verwendung speichern.

Sie müssen bei der SharePoint-Verwaltungsshell das Snap-In, das die Cmdlets enthält, nicht registrieren. Die Registrierung des Microsoft.SharePoint.PowerShell.dll Moduls für SharePoint Server-Cmdlets erfolgt automatisch, als Ergebnis der Add-PSSnapin-Microsoft. SharePoint.PowerShell-Zeile in der SharePoint.ps1 Datei, die sich in %CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration befindet, wobei Version "15" gleich SharePoint Server 2013 und Version "16" gleich SharePoint Server 2016 ist. Zur Verwendung der PowerShell-Konsole müssen Sie dieses Snap-In manuell registrieren.

Unabhängig davon, ob Sie die SharePoint-Verwaltungsshell- oder die PowerShell-Konsole verwenden, können Sie auch zusätzliche Snap-Ins laden.

Hinweis

Die SharePoint Management Shell- und die PowerShell-Konsole unterscheiden sich auch bezüglich der Verwendung der Option ReuseThread, die definiert, wie das Threadingmodell verwendet wird. Die Verwendung durch die SharePoint-Verwaltungsshell wird durch die Zeile {Host.Runspace.ThreadOptions = "ReuseThread"} definiert, die sich in der Datei „SharePoint.ps1“ befindet. Weitere Informationen finden Sie unterPS ThreadOptions.

Berechtigungen

Um Benutzern die Berechtigung zu erteilen, SharePoint Server-Cmdlets ausführen zu können, Stellen Sie vor der Verwendung des Add-SPShellAdmin -Cmdlets sicher, dass die folgenden Mindestanforderungen vollständig erfüllt sind:

• Sie müssen Mitglied der festen Serverrolle securityadmin auf der SQL Server-Instanz sein.
• Sie müssen Mitglied der Gruppe Administratoren auf dem Server sein, auf dem das PowerShell-Cmdlet ausgeführt wird.

Hinweis

Wenn diese Voraussetzungen nicht erfüllt sind, setzen Sie sich mit dem Setup-Administrator oder SQL Server-Administrator in Verbindung, damit Ihnen diese Berechtigungen erteilt werden.

Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

Wenn Sie nicht Mitglied der SharePoint_Shell_Access -Rolle oder der lokalen Gruppe WSS_Admin_WPG sind, fügen Sie die WSS_Admin_WPG -Gruppe mithilfe des Add-SPShellAdmin -Cmdlets auf allen Front-End-Webservern in der SharePoint-Farm und der SharePoint_Shell_Access -Rolle hinzu. Wenn die SQL Server-Datenbank nicht über eine SharePoint_Shell_Access -Rolle verfügt, wird die Rolle automatisch beim Ausführen des Add-SPShellAdmin -Cmdlets erstellt. Nach dem Ausführen des Add-SPShellAdmin -Cmdlets können Benutzer SharePoint PowerShell-Cmdlets in einer Farmumgebung mit mehreren Servern ausführen.

Hinweis

Wenn Sie SharePoint Server installieren, wird dem Benutzerkonto, das Sie zur Ausführung der Installation verwenden, die entsprechenden Berechtigungen zur Ausführung von PowerShell-Cmdlets erteilt. Wenn noch keine Benutzer hinzugefügt wurden, um ein PowerShell-Cmdlet auszuführen, können Sie sie mithilfe des Add-SPShellAdmin -Cmdlets hinzufügen.

Wenn Sie eine Liste aller SPShellAdmin-Cmdlets anzeigen möchten, geben Sie an einer PowerShell-Eingabeaufforderung Get-Command -Noun SPShellAdmin ein.

Skripts und Ausführungsrichtlinien

Obwohl Sie mit Microsoft PowerShell auch einzelne administrative Aufgaben ausführen können, können Sie auch ein Skript zum Automatisieren einer Serie von Aufgaben erstellen. Ein Skript ist eine Textdatei, die einen oder mehrere Microsoft PowerShell-Befehle enthält. Microsoft PowerShell-Skripts haben die Dateinamenerweiterung PS1.

Zur Ausführung von Skripts ist RemoteSigned die mindestens erforderliche Ausführungsrichtlinie für SharePoint Server, während die Standardrichtlinie für PowerShell „Restricted" ist. Wenn die Richtlinie „Restricted" beibehalten wird, ändert die SharePoint-Verwaltungsshell die Richtlinie für PowerShell in „RemoteSigned". Das bedeutet, dass Sie Als Administrator ausführen auswählen müssen, um die SharePoint-Verwaltungsshell mit erhöhten Administratorrechten auszuführen. Diese Änderung gilt dann für alle PowerShell-Sitzungen. Weitere Informationen finden Sie unter ExecutionPolicy Enumeration.

Zusätzliche Informationen zu Skripts und Ausführungsrichtlinien finden Sie unter about_scripts bzw. About_Execution_Policies.