Übersicht über das Microsoft.SharePoint.PowerShell-Modul

Eine Liste der SharePoint Server-Cmdlets finden Sie unter Microsoft.SharePoint.Powershell-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.

Mit der SharePoint-Verwaltungsshell müssen Sie das Snap-In, das die Cmdlets enthält, nicht registrieren. Die Registrierung erfolgt über die Add-PSSnapin Microsoft.SharePoint.PowerShell Zeile in der SharePoint.ps1 Datei. Diese Datei befindet sich im %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration Ordner.

• <version> 15 entspricht SharePoint Server 2013
• und <version> 16 gleich SharePoint Server 2016

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 und Module 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 der SharePoint-Verwaltungsshell wird durch diese Zeile definiert, {Host.Runspace.ThreadOptions = "ReuseThread"}die sich in der SharePoint.ps1 Datei befindet. Weitere Informationen finden Sie unterPS ThreadOptions.

Berechtigungen

Bevor Sie das Add-SPShellAdmin Cmdlet verwenden können, um Benutzern Berechtigungen zum Ausführen von SharePoint Server-Cmdlets zu erteilen, überprüfen Sie, ob Sie alle folgenden Mindestanforderungen erfüllen:

• Sie müssen über die Mitgliedschaft in der festen Serverrolle SecurityAdmin auf dem SQL Server instance verfügen.
• 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 in der rolle SharePoint_Shell_Access oder WSS_Admin_WPG lokalen Gruppe sind, verwenden Sie das Add-SPShellAdmin Cmdlet, um die gruppe WSS_Admin_WPG allen Front-End-Webservern in der SharePoint-Farm und der rolle SharePoint_Shell_Access hinzuzufügen. Wenn die SQL Server-Datenbank keine SharePoint_Shell_Access Rolle aufweist, wird die Rolle beim Ausführen des Add-SPShellAdmin Cmdlets automatisch erstellt. Nachdem Sie das Add-SPShellAdmin Cmdlet ausgeführt haben, 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 keine Benutzer zum Ausführen eines PowerShell-Cmdlets hinzugefügt wurden, können Sie sie mit dem Add-SPShellAdmin Cmdlet hinzufügen.

Um eine Liste aller SPShellAdmin-Cmdlets anzuzeigen, geben Sie an einer PowerShell-Eingabeaufforderung ein Get-Command -Noun SPShellAdmin.

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 verfügen über eine .ps1 Dateinamenerweiterung.

Zum Ausführen von Skripts ist die mindestens erforderliche Ausführungsrichtlinie für SharePoint Server RemoteSigned, obwohl die Standardrichtlinie für PowerShell eingeschränkt ist. Wenn die Richtlinie als Eingeschränkt 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 für alle PowerShell-Sitzungen. Weitere Informationen zu Skripts und Ausführungsrichtlinien finden Sie unter about_scripts und Informationen zu Ausführungsrichtlinien.