SharePoint Online und Teams mit PowerShell verwalten โ€“ eine Einfรผhrung

Um SharePoint Online oder Teams zu verwalten oder zu konfigurieren nutzt man normalerweise das Microsoft 365 Admin Center. Sobald es jedoch um komplexere oder sich wiederholende Aufgaben geht, ist die PowerShell das ideale Werkzeug. Die in Windows integrierte Kommandozeile ermรถglicht die Steuerung vieler Produkte wie Azure, Teams oder Exchange Online mit entsprechenden PowerShell-Erweiterungsmodulen. Wie Sie die SharePoint Online PowerShell starten und mit den ersten Befehlen loslegen erklรคrt die folgende Anleitung.

Vorbemerkung: SharePoint oder Teams mit PowerShell?

Um mit der PowerShell zu starten, mรผssen vorab einige Initialisierungsschritte vorgenommen werden. Dieser Beitrag erklรคrt das am Beispiel SharePoint Online. Die davon leicht abweichenden Schritte fรผr Teams finden Sie in diesem Beitrag: Grundlagen Teams-Verwaltung mit PowerShell

1. Zuerst das PowerShell-Modul installieren

Um die Windows-PowerShell einsetzen zu kรถnnen, mรผssen Sie zunรคchst eine Verbindung mit SharePoint Online herstellen. Dafรผr ist zunรคchst die Installation des SharePoint Online PowerShell-Moduls erforderlich, die Sie in folgenden Schritten bewerkstelligen:

1. Klicken Sie zum Start der PowerShell mit der rechten Maustaste auf den Startknopf, und wรคhlen Sie hier Windows PowerShell (Administrator) aus. Wichtig ist, dass Sie die PowerShell auf diese Art mit administrativen Rechten ausfรผhren, da die Installation sonst fehlschlรคgt.

2. In der Konsole geben Sie als ersten Befehl folgendes CMDlet ein:

Install-Module -Name Microsoft.Online.SharePoint.Powershell

3. Achtung: Oft taucht schon zu Beginn eine Fehlermeldung auf, mit dem Hinweis โ€žCould not Autoload Matching Modulesโ€œ. Der Grund dafรผr liegt in einer Beschrรคnkung der Ausfรผhrungsrichtlinie.

Teams mit PowerShell

Das lรคsst sich einfach beheben mit folgendem Befehl, auf den Sie mit โ€žAโ€œ Anworten:

Set-ExecutionPolicy Unrestricted

4. Nun also nochmal den Befehl aus Punkt 2 eingeben. Die darauf folgende Installationsabfrage der PowerShell ist mit ja zu beantworten. Ob das Modul bereits auf dem Rechner oder Server installiert wurde, kรถnnen Sie zu Beginn ebenfalls prรผfen, mit dem CMDlet

Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable | Select Name,Version

5. Hier sollte dann folgende Ausgabe in zurรผckgegeben werden:

SharePoint Online PowerShell

2. SharePoint Online PowerShell updaten

Die Version des Moduls kann durchaus abweichend sein je nach Entwicklungsstand. Sofern die Installation des Moduls bereits vor lรคngerer Zeit durchgefรผhrt wurde, empfiehlt sich ein Update. Dafรผr nutzen Sie folgendes CMDlet:

Update-Module -Name Microsoft.Online.SharePoint.PowerShell

Zum Zeitpunkt dieses Artikels entsprach die abgebildete Version der aktuellsten Version. Sofern Sie nach der Installation einen รœberblick der im Modul verfรผgbaren CMDlets erhalten mรถchten, kรถnnen Sie das mit folgendem Befehl durchfรผhren:

get-command -Module Microsoft.Online.SharePoint.PowerShell
SharePoint Online PowerShell

Die Ausgabe ist in diesem Fall recht umfangreich und wird nach jedem Update des Moduls verรคndert beziehungsweise erweitert.

An diesem Punkt ist die Installation des SharePoint-Moduls fรผr die PowerShell erledigt, weiter geht es mit dem Verbindungsaufbau zu SharePoint Online.

3. SharePoint Online mit PowerShell verbinden

Wie bei allen anderen Diensten aus Microsoft 365 mรผssen Sie sich รผber die PowerShell erst einmal mit Ihrem SharePoint Online verbinden, bevor Sie die ersten CMDlets oder Skripte am Server starten kรถnnen. Das gelingt mit folgendem Befehl:

Connect-SPOService -URL โ€žTenant + Adminsite + Sharepoint.comโ€œ

In unserem Fall muss es wie im Screenshot also lauten:

Connect-SPOService -URL https://rolandeich-admin.sharepoint.com
SharePoint Online PowerShell

Die Anmeldung kann sowohl mit als auch ohne Multifaktor-Authentifizierung (MFA) erfolgen.

4. Typische PowerShell Fehlermeldungen

โ€“ Fehlermeldung โ€žConnect-SPOService : Current site is not a tenant administration siteโ€œ ?

Falls Sie bei der Anmeldung die Fehlermeldung โ€žConnect-SPOService : Current site is not a tenant administration siteโ€œ erhalten, haben Sie wahrscheinlich โ€ž-adminโ€œ-Suffix wie in der obigen Zeile vergessen.

โ€“ Fehlermeldung โ€œModule could not be loadedโ€œ

Falls Sie die Fehlermeldung โ€œModule could not be loadedโ€œ erhalten, liegt das vermutlich an einer beschrรคnkten PowerShell-Ausfรผhrungsrichtlinie. Der folgende Befehl zeigt das an:

Get-ExecutionPolicy

Falls Sie hier AllSigned zurรผckbekommen, blockiert Ihre Richtlinie unsignierte Module. Beheben kรถnnen sie diese Sperre mit dem Befehl, der die Richtlinie fรผr Ihren Benutzerkontext aufhebt:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser

5. SharePoint Online PowerShell Befehle zum Einstieg

Nachdem Sie die Verbindung zu SharePoint Online hergestellt haben, kรถnnen Sie mit ersten Verwaltungsschritten beginnen. Hier als Beispiel einige nรผtzliche PowerShell-Befehle:

SharePoint Online PowerShell

Get-SPOTenant listet alle Einstellungen fรผr diesen Mandanten auf, incl. Kontingentstatus und Freigabefunktionen.

Mit NEW-SPOSite kรถnnen Sie eine neue Websitesammlung anlegen. Genauso kรถnnen Sie Get-SPOSite nutzen, um bestehende Seiten aufzulisten:

SharePoint Online PowerShell

Die Syntax zum Anlegen einer neuen Seite lautet wie folgt:

New-SPOSite -Url "https://IhrSiteName.sharepoint.com/Sites/NeuerSitename" -Owner user@beispiel.de -StorageQuota 100 -Title "Neue Site via PowerShell"

Mit Get-SPOSiteGroup erhalten Sie einen รœberblick, welche Gruppen auf einer Seite verfรผgbar sind.

SharePoint Online PowerShell

Mit Add-SPOUser kรถnnen Sie einen  neuen User zu einer Seite hinzufรผgen. Dieser muss aber gleichzeitig auch Mitglied einer Gruppe werden.

Add-SPOUser https://IhrSiteName.sharepoint.com/sites/ExchangeAllgemein โ€“Loginname max.mustermann@smartsocke-cloud.de -Group "Besitzer von Exchange Allgemein"

Diese Befehlsbeispiele bilden natรผrlich nur einen Ausschnitt der vielfรคltigen Mรถglichkeiten der PowerShell in SharePoint. Zu jedem der hier gezeigtem Befehle gibt es darรผber hinaus (je nach Verfรผgbarkeit) noch die Mรถglichkeit, ein Get- Set- ADD- NEW oder Remove zu verwenden, je nach Einsatzzweck.

6. Teams administrieren mit der PowerShell

Analog zur Verwaltung von SharePoint Online bietet die PowerShell auch vielfรคltige Befehle fรผr die Administration von Microsoft Teams. Die Grundlagen dafรผr haben wir hier beschrieben.

Avatar fรผr Roland Eich