Verwalten von SharePoint 2010-Produkten mit Windows PowerShell

 

Gilt für: SharePoint Foundation 2010

Letztes Änderungsdatum des Themas: 2017-01-18

In diesem Artikel wird beschrieben, wie Windows PowerShell mit Microsoft SharePoint 2010-Produkte verwendet wird. Außerdem erhalten Sie eine Übersicht über die grundlegenden Cmdlets von Windows PowerShell sowie den erforderlichen Konzepten, entsprechend denen Sie diese effizienten Funktionen optimal nutzen können.

Inhalt dieses Artikels:

  • Übersicht

  • Zugreifen auf Windows PowerShell für SharePoint 2010-Produkte mithilfe der SharePoint 2010-Verwaltungsshell

  • Berechtigungen

  • Skripts und Ausführungsrichtlinien

  • Erlernen von Windows PowerShell

Übersicht

Windows PowerShell ist ein Befehlszeilen-Skripttool, mit dem Administratoren über uneingeschränkten Zugriff auf entsprechende Anwendungsprogrammierschnittstellen (Application Programming Interfaces, APIs) verfügen und in der Lage sind, direkt mit SharePoint 2010-Produkte zu kommunizieren, um Webanwendungen, Websitesammlungen, Websites, Listen und viele andere Elemente zu bearbeiten. Darüber hinaus können Administratoren Skripts für Cmdlets (ausgesprochen "Command-lets") schreiben, wodurch die Benutzererfahrung gegenüber früheren Produktversionen verbessert wird.

Windows PowerShell 2,0 ist eine Voraussetzung für die Installation von SharePoint 2010-Produkte. Die Installation erfolgt bei Bedarf, wenn Sie das Vorbereitungstool für Microsoft SharePoint-Produkte ausführen. Windows PowerShell befindet sich standardmäßig unter folgendem Pfad: <%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe.

Hinweis

Windows PowerShell 2,0 ist abwärtskompatibel mit Windows PowerShell 1.0 und wird daher im Ordner v1.0 installiert.

Eine Liste von neuen Features für Windows PowerShell, Version 2.0 finden Sie unter Windows PowerShell 2.0 (https://go.microsoft.com/fwlink/?linkid=113247&clcid=0x407).

Ein interaktives Tool und eine interaktive Anleitung zum Erlernen der Windows PowerShell-Syntax finden Sie unter Windows PowerShell Command Builder bzw. im Handbuch für die ersten Schritte zu diesem Tool.

Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Zugreifen auf Windows PowerShell für SharePoint 2010-Produkte

Nach dem Installieren der SharePoint 2010-Produkte sind die entsprechenden Windows PowerShell-Cmdlets über die SharePoint 2010-Verwaltungsshell verfügbar. Sie sind auch über die Windows PowerShell-Konsole zugänglich. Mit der Verwaltungsshell können Sie jeden Aspekt von SharePoint 2010-Produkte verwalten. Sie können neue Websitesammlungen, Webanwendungen, Benutzerkonten, Dienstanwendungen, Proxys und viele andere Elemente erstellen. Die Befehle der Verwaltungsshell geben SharePoint-Objekte aus, die auf der Microsoft .NET-Plattform basieren. Diese Objekte können als Eingabe für nachfolgende Befehle übernommen oder in lokalen Variablen für die spätere Verwendung gespeichert werden.

Sie müssen bei der Verwaltungsshell nicht das Snap-In registrieren, das die Cmdlets enthält. Die Registrierung des Moduls Microsoft.SharePoint.PowerShell.dll für SharePoint 2010-Cmdlets erfolgt automatisch, infolge der Zeile Add-PSSnapin Microsoft.SharePoint.PowerShell in der Datei SharePoint.ps1 in %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Config\PowerShell\Registration. Wenn Sie die Windows PowerShell-Konsole verwenden, müssen Sie dieses Snap-In manuell registrieren.

Sie können auch zusätzliche Snap-Ins laden, wobei es keine Rolle spielt, ob Sie die Verwaltungsshell oder die Windows PowerShell-Konsole verwenden. Weitere Informationen finden Sie unter Anpassen von Profilen (https://go.microsoft.com/fwlink/?linkid=183166&clcid=0x407).

So greifen Sie auf die SharePoint 2010-Verwaltungsshell zu

  1. Klicken Sie im Startmenüauf Alle Programme.

  2. Klicken Sie auf Microsoft SharePoint 2010-Produkte.

  3. Klicken Sie auf SharePoint 2010-Verwaltungsshell.

Hinweis

Die SharePoint 2010-Verwaltungsshell und die Windows PowerShell-Konsole unterscheiden sich auch hinsichtlich der Verwendung der ReuseThread-Option, die definiert, wie das Threadmodell verwendet wird. Die Verwendung durch die Verwaltungsshell wird durch die Zeile {Host.Runspace.ThreadOptions = "ReuseThread"} definiert, die sich in der Datei SharePoint.ps1 befindet. Weitere Informationen finden Sie unter PSThreadOptions-Enumeration (https://go.microsoft.com/fwlink/?linkid=183145&clcid=0x407).

Berechtigungen

Vergewissern Sie sich vor dem Verwenden der Cmdlets der Verwaltungsshell und der Windows PowerShell, dass die folgenden Mindestanforderungen erfüllt sind: Weitere Informationen finden Sie unter Add-SPShellAdmin.

Wenn Sie kein Mitglied der Rolle SharePoint_Shell_Access oder der lokalen Gruppe WSS_Admin_WPG sind, verwenden Sie das Add-SPShellAdmin-Cmdlet. Bei Verwendung des Add-SPShellAdmin-Cmdlets wird der Benutzer der Gruppe WSS_Admin_WPG auf allen Front-End-Webservern und der Rolle SharePoint_Shell_Access hinzugefügt. Wenn die Zieldatenbank über keine Rolle SharePoint_Shell_Access verfügt, wird die Rolle automatisch erstellt. Nach dem Ausführen des Add-SPShellAdmin-Cmdlets kann der Benutzer SharePoint 2010 Windows PowerShell-Cmdlets in einer Farmumgebung mit mehreren Servern ausführen.

Wenn Sie das Add-SPShellAdmin-Cmdlet ausführen, um der Rolle SharePoint_Shell_Access einen Benutzer hinzuzufügen, müssen Sie über die folgenden Sicherheitsberechtigungen verfügen:

  • Zugriff auf die Serverrolle Securityadmin für die SQL-Instanz und die Rolle db_owner in einer Datenbank

  • Administratorberechtigungen für den lokalen Computer

Hinweis

Normalerweise muss die Person, die das Add-SPShellAdmin-Cmdlet verwendet, dem Benutzerkonto zugeordnet sein, das für Setup verwendet wurde.

Sie müssen das Add-SPShellAdmin-Cmdlet für alle Datenbanken ausführen, für die Sie Zugriff gewähren möchten. Wenn keine Datenbank angegeben wird, wird die Serverfarm-Konfigurationsdatenbank verwendet. Wenn Sie eine Datenbank angeben, wird die Serverfarm-Inhaltsdatenbank zusätzlich zur angegebenen Serverfarm-Konfigurationsdatenbank berücksichtigt.

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

Skripts und Ausführungsrichtlinien

Sie können mit Windows PowerShell auch einzelne administrative Aufgaben ausführen. Die wirkliche Stärke von Windows PowerShell-Cmdlets liegt jedoch darin, dass Sie damit ein Skript zum Automatisieren einer Serie von Aufgaben erstellen können. Ein Skript ist eine reine Textdatei, die einen oder mehrere Windows PowerShell-Befehle enthält. Windows PowerShell-Skripts haben die Dateinamenerweiterung PS1.

Achten Sie beim Verwenden eines Skripts darauf, dass die mindestens erforderliche Ausführungsrichtlinie für SharePoint 2010-ProdukteRemoteSigned ist, während die Standardrichtlinie für Windows PowerShell Restricted ist. Wenn die Richtlinie Restricted beibehalten wird, ändert die SharePoint&nbsp;2010-Verwaltungsshell die Richtlinie für Windows PowerShell auf RemoteSigned. Das bedeutet, dass die SharePoint&nbsp;2010-Verwaltungsshell mit erhöhter Administratorberechtigung gestartet werden muss, indem Als Administrator ausführen ausgewählt wird. Diese Änderung gilt dann für alle Windows PowerShell-Sitzungen.

Weitere Informationen zu Skripts und Ausführungsrichtlinien finden Sie unter about_scripts bzw. about_Execution_Policies.

Erlernen von Windows PowerShell

Es sind verschiedene Windows PowerShell-Lernressourcen für SharePoint-IT-Experten verfügbar, die nicht mit Windows PowerShell vertraut sind.

TechNet Scripting Center

Das TechNet Scripting Center umfasst viele Ressourcen zum Erlernen der Grundlagen für die Verwendung von Windows PowerShell. Es enthält auch Skriptrepositorys mit Beispielen für Skripts, die häufig mit verschiedenen Microsoft-Produkten verwendet werden. In der folgenden Tabelle sind die wichtigsten Schulungsressourcen aufgelistet.

Seite Beschreibung

Windows PowerShell-Dokumentation über TechNet (https://go.microsoft.com/fwlink/?linkid=187813&clcid=0x407)

Dieser Abschnitt der TechNet Library enthält Webkopien der wichtigsten Windows PowerShell-Hilfethemen. Der Abschnitt bietet außerdem Webkopien des Windows PowerShell Erste Schritte-Dokuments, der PowerShell.exe-Hilfe und eine Windows PowerShell-Einführung.

Skripterstellung mit Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187815&clcid=0x407)

Die Homepage für Schulungsressourcen für die Skripterstellung mit Windows PowerShell.

Windows PowerShell Owner's Manual (https://go.microsoft.com/fwlink/?linkid=187817&clcid=0x407)

Webbasiertes Handbuch für die ersten Schritte mit Windows PowerShell.

Windows PowerShell-Kurzübersicht (https://go.microsoft.com/fwlink/?linkid=187819&clcid=0x407)

Herunterladbare Kopie des Kurzübersichtsdokuments, das mit Windows PowerShell installiert wird.

Windows PowerShell-Dokumente

Windows PowerShell installiert in der Windows PowerShell 1.0-Programmgruppe die im Folgenden aufgeführten Dokumente. Sie können auch nach dem Herunterladen des Windows PowerShell 1.0 Documentation Pack (https://go.microsoft.com/fwlink/?linkid=187822&clcid=0x407) installiert werden.

Datei Beschreibung

GettingStarted.rtf

Beschreibt den Einstieg in die Arbeit mit Windows PowerShell.

UsersGuide.rtf

Eine Einführung in die Windows PowerShell-Umgebung und -Sprache.

QuadFold.rtf

Ein ausdruckbare Kurzübersicht für häufig verwendete Windows PowerShell-Syntax und -Befehle. Auch als Download im TechNet Scripting Center verfügbar.

Beachten Sie beim Nutzen dieser Ressourcen, dass Sie sich vor der Arbeit mit Windows PowerShell für SharePoint 2010-Produkte mit den folgenden hilfreichen Konzepten und Cmdlets vertraut machen sollten: