Der ultimative Guide für Admins: **Wie greife ich mit Powershell7 auf SharePoint zu?**

Als **SharePoint-Admin** wissen Sie, dass Effizienz und Automatisierung der Schlüssel zur Bewältigung komplexer Aufgaben sind. Manuelle Prozesse sind zeitaufwendig, fehleranfällig und skalieren schlecht. Hier kommt **PowerShell 7** ins Spiel – die moderne, plattformübergreifende Skriptsprache von Microsoft, die in Kombination mit den richtigen Modulen die Verwaltung Ihrer SharePoint-Umgebung revolutionieren kann. Dieser umfassende Guide führt Sie Schritt für Schritt durch den Prozess, wie Sie mit PowerShell 7 auf **SharePoint Online** zugreifen und Ihre administrativen Aufgaben optimieren können.

## Warum PowerShell 7 für SharePoint-Admins unerlässlich ist

**PowerShell 7** bietet gegenüber seinen Vorgängern zahlreiche Vorteile: Es ist **plattformübergreifend** (läuft auf Windows, macOS und Linux), schneller, verfügt über neue Operatoren und verbesserte Fehlerbehandlung. Für **SharePoint-Admins** bedeutet dies:
* **Automatisierung**: Wiederkehrende Aufgaben wie die Erstellung von Websitesammlungen, die Verwaltung von Benutzerberechtigungen oder die Berichterstellung können automatisiert werden.
* **Effizienz**: Massenoperationen, die im SharePoint-Admin-Center mühsam wären, lassen sich mit einem einzigen Skript ausführen.
* **Konsistenz**: Skripte stellen sicher, dass Aufgaben immer auf die gleiche Weise ausgeführt werden, wodurch menschliche Fehler minimiert werden.
* **Moderne Entwicklung**: Es ist die bevorzugte Wahl für die Integration in moderne CI/CD-Pipelines und Cloud-Workflows.

In diesem Guide konzentrieren wir uns hauptsächlich auf **SharePoint Online (SPO)** und das leistungsstarke **PnP.PowerShell**-Modul, welches die bevorzugte Wahl für die Interaktion mit SharePoint im Kontext von Microsoft 365 ist.

## Die Grundlagen: Was Sie benötigen, bevor Sie starten

Bevor wir in die Befehle eintauchen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:

### 1. PowerShell 7 Installation
Stellen Sie sicher, dass **PowerShell 7** (oder höher) auf Ihrem System installiert ist. Sie können es von der offiziellen Microsoft-Dokumentation herunterladen oder über den Microsoft Store installieren. Um Ihre Version zu überprüfen, öffnen Sie eine PowerShell-Konsole und geben Sie ein:
„`powershell
$PSVersionTable.PSVersion
„`
Die Hauptversion sollte 7 oder höher sein.

### 2. Administratorberechtigungen
Für die Installation von PowerShell-Modulen benötigen Sie lokale Administratorrechte auf Ihrem System. Für den Zugriff auf SharePoint benötigen Sie entsprechende Berechtigungen in Ihrer **SharePoint Online-Umgebung** (z.B. SharePoint-Administrator, globale Administratorrolle oder spezielle Website-Sammlungsadministratorrechte).

### 3. Das PnP.PowerShell-Modul
Das **PnP.PowerShell**-Modul ist das Herzstück unserer Interaktion mit **SharePoint Online**. Es basiert auf dem SharePoint Client-Side Object Model (CSOM) und bietet eine Fülle von Cmdlets, die die Verwaltung von SharePoint vereinfachen.

## Schritt-für-Schritt: PnP.PowerShell installieren

Die Installation des **PnP.PowerShell**-Moduls ist denkbar einfach und erfolgt über den PowerShell-Befehl `Install-Module`.

1. **Öffnen Sie PowerShell 7 als Administrator**: Klicken Sie mit der rechten Maustaste auf das PowerShell 7-Symbol und wählen Sie „Als Administrator ausführen”.

2. **Modul installieren**: Geben Sie den folgenden Befehl ein und bestätigen Sie die Installation, wenn Sie dazu aufgefordert werden (typischerweise mit ‘Y’ für Ja oder ‘A’ für Alle):
„`powershell
Install-Module -Name PnP.PowerShell -Scope CurrentUser -Force
„`
* `-Name PnP.PowerShell`: Spezifiziert den Namen des zu installierenden Moduls.
* `-Scope CurrentUser`: Installiert das Modul nur für den aktuellen Benutzer. Für eine systemweite Installation können Sie `-Scope AllUsers` verwenden, dies erfordert jedoch in der Regel erhöhte Berechtigungen.
* `-Force`: Erzwingt die Installation, was nützlich ist, wenn Sie das Modul aktualisieren möchten oder Probleme mit einer früheren Installation hatten.

3. **Installation überprüfen**: Nach der Installation können Sie überprüfen, ob das Modul erfolgreich geladen wurde:
„`powershell
Get-Module -ListAvailable -Name PnP.PowerShell
„`
Sie sollten Informationen über das installierte Modul sehen.

## Verbindung zu SharePoint Online herstellen

Die Verbindung zu Ihrer **SharePoint Online-Umgebung** ist der nächste entscheidende Schritt. Das **PnP.PowerShell**-Modul bietet hierfür das Cmdlet `Connect-PnPOnline`. Es gibt verschiedene Authentifizierungsmethoden, aber die gängigsten sind die interaktive Authentifizierung und die Authentifizierung per App-Registrierung für Automatisierungsszenarien.

### 1. Interaktive Authentifizierung (für manuelle Aufgaben)

Dies ist die einfachste Methode für Ad-hoc-Aufgaben und Skripte, die manuell ausgeführt werden. Sie werden in einem Browserfenster zur Eingabe Ihrer Microsoft 365-Anmeldeinformationen aufgefordert.

„`powershell
Connect-PnPOnline -Url https://yourtenant.sharepoint.com/sites/YourSiteName -Interactive
„`
* Ersetzen Sie `https://yourtenant.sharepoint.com/sites/YourSiteName` durch die URL der SharePoint-Website, mit der Sie sich verbinden möchten. Sie können sich auch mit der Tenant-Admin-URL verbinden, z.B. `https://yourtenant-admin.sharepoint.com`.
* Das `-Interactive`-Flag öffnet ein Anmeldefenster in Ihrem Standardbrowser.

### 2. Authentifizierung per App-Registrierung (für Automatisierung und Skripte)

Für Skripte, die unbeaufsichtigt ausgeführt werden sollen (z.B. in geplanten Aufgaben oder Azure Automation), ist die App-Only-Authentifizierung über eine Azure AD App-Registrierung die sicherste und empfehlenswerteste Methode.

#### Schritte zur Einrichtung einer Azure AD App-Registrierung:
1. **Azure-Portal öffnen**: Gehen Sie zu [portal.azure.com](https://portal.azure.com) und melden Sie sich an.
2. **Azure Active Directory**: Navigieren Sie zu „Azure Active Directory” > „App-Registrierungen” > „Neue Registrierung”.
3. **App registrieren**:
* Geben Sie einen Namen für die App ein (z.B. „PnP-SharePoint-Automation”).
* Wählen Sie unter „Unterstützte Kontotypen” „Nur Konten in diesem Organisationsverzeichnis” (Standard).
* Der „Umleitungs-URI” ist für dieses Szenario nicht relevant, kann aber auf `https://localhost` gesetzt werden, falls benötigt.
* Klicken Sie auf „Registrieren”.
4. **Client-ID notieren**: Notieren Sie die „Anwendungs-ID (Client)” – dies ist Ihre Client-ID.
5. **Client-Geheimnis erstellen**:
* Navigieren Sie in der App-Registrierung zu „Zertifikate & Geheimnisse” > „Neues Clientgeheimnis”.
* Geben Sie eine Beschreibung ein und wählen Sie eine Gültigkeitsdauer. Klicken Sie auf „Hinzufügen”.
* **WICHTIG**: Notieren Sie den „Wert” des Clientgeheimnisses SOFORT, da er nach dem Verlassen der Seite nicht mehr sichtbar ist. Bewahren Sie dieses Geheimnis sicher auf!
6. **API-Berechtigungen erteilen**:
* Navigieren Sie in der App-Registrierung zu „API-Berechtigungen” > „Berechtigung hinzufügen”.
* Wählen Sie „SharePoint-Dienst”.
* Wählen Sie unter „Anwendungsberechtigungen” die benötigten Berechtigungen aus (z.B. `Sites.FullControl.All` für umfassenden Zugriff oder spezifischere Berechtigungen wie `Sites.Read.All`, `Sites.Manage.All`). Achten Sie darauf, nur die minimal erforderlichen Berechtigungen zu vergeben.
* Klicken Sie auf „Berechtigungen hinzufügen” und anschließend auf „Administratorzustimmung für [Ihr Tenant] erteilen”.

#### Verbindung mit Client-ID und Geheimnis:
„`powershell
$clientId = „Ihre_Client_ID” # Anwendungs-ID (Client) aus Azure AD
$clientSecret = „Ihr_Client_Geheimnis” # Der Wert des Client-Geheimnisses
$tenantName = „yourtenant” # Ihr Tenant-Name, z.B. contoso

Connect-PnPOnline -Url „https://$tenantName.sharepoint.com” -ClientId $clientId -ClientSecret $clientSecret
„`
Diese Methode ermöglicht es Ihren Skripten, sich ohne Benutzerinteraktion bei SharePoint zu authentifizieren.

### 3. Verbindung trennen
Nachdem Sie Ihre Aufgaben erledigt haben, ist es gute Praxis, die Verbindung zu trennen:
„`powershell
Disconnect-PnPOnline
„`

## Grundlegende SharePoint-Operationen mit PnP.PowerShell

Nachdem Sie die Verbindung hergestellt haben, können Sie mit den **PnP.PowerShell**-Cmdlets beginnen, Ihre SharePoint-Umgebung zu verwalten. Hier sind einige grundlegende Beispiele:

### 1. Informationen über die aktuelle Website abrufen
„`powershell
Get-PnPSite
Get-PnPWeb
„`
`Get-PnPSite` liefert Informationen über die aktuelle Websitesammlung, während `Get-PnPWeb` Details über die aktuelle Unterwebsite bereitstellt.

### 2. SharePoint-Listen verwalten
* **Alle Listen abrufen**:
„`powershell
Get-PnPList
„`
* **Eine spezifische Liste abrufen**:
„`powershell
Get-PnPList -Identity „Meine Dokumente”
„`
* **Eine neue Liste erstellen**:
„`powers揹
New-PnPList -Title „Projekt-Aufgaben” -Template GenericList
„`
* **Listenelemente hinzufügen**:
„`powershell
$list = Get-PnPList -Identity „Projekt-Aufgaben”
Add-PnPListItem -List $list -Values @{„Title”=”Implementierung”; „Status”=”Offen”}
„`
* **Listenelemente aktualisieren**:
„`powershell
$item = Get-PnPListItem -List „Projekt-Aufgaben” -Query „Implementierung”
Set-PnPListItem -List „Projekt-Aufgaben” -Identity $item.Id -Values @{„Status”=”Abgeschlossen”}
„`
* **Eine Liste löschen**:
„`powershell
Remove-PnPList -Identity „Projekt-Aufgaben” -Force
„`

### 3. Dateien und Ordner verwalten
* **Alle Dateien in einer Bibliothek abrufen**:
„`powershell
Get-PnPFile -Url /Shared%20Documents/ -AsString # Zeigt Dateinamen
„`
* **Eine Datei hochladen**:
„`powershell
Add-PnPFile -Path „C:tempMeinDokument.docx” -Folder „Shared Documents” -NewFileName „Bericht_2023.docx”
„`
* **Eine Datei herunterladen**:
„`powershell
Get-PnPFile -Url „/Shared Documents/Bericht_2023.docx” -Path „C:Downloads” -FileName „Bericht_Lokal.docx” -AsFile
„`
* **Einen Ordner erstellen**:
„`powershell
Add-PnPFolder -Name „Neue_Projekte” -Folder „Shared Documents”
„`
* **Eine Datei löschen**:
„`powershell
Remove-PnPFile -Url „/Shared Documents/Bericht_2023.docx” -Recycle
„`

### 4. Benutzer und Berechtigungen verwalten
* **Alle Benutzer einer Gruppe abrufen**:
„`powershell
Get-PnPGroupMember -Identity „Websitebesitzer”
„`
* **Einen Benutzer zu einer Gruppe hinzufügen**:
„`powershell
Add-PnPGroupMember -Identity „Websitebesitzer” -Users „[email protected]”
„`
* **Benutzerberechtigungen auf Elementebene setzen**:
„`powershell
$item = Get-PnPListItem -List „Projekt-Aufgaben” -Id 1
Set-PnPListItemPermission -List „Projekt-Aufgaben” -Identity $item.Id -User „[email protected]” -AddRole „Lesen”
„`

Dies sind nur einige Beispiele. Das **PnP.PowerShell**-Modul bietet Hunderte von Cmdlets für fast jede erdenkliche SharePoint-Verwaltungsaufgabe.

## Erweiterte Szenarien und Best Practices

### Skripting und Automatisierung
Der wahre Nutzen von PowerShell entfaltet sich in der **Automatisierung**. Speichern Sie Ihre Befehlssequenzen in `.ps1`-Dateien und führen Sie diese aus. Verwenden Sie Parameter in Ihren Skripten, um sie flexibel und wiederverwendbar zu machen.

### Fehlerbehandlung
In produktiven Skripten ist eine robuste Fehlerbehandlung unerlässlich. Verwenden Sie `try-catch`-Blöcke, um potenzielle Fehler abzufangen und zu protokollieren:
„`powershell
try {
Connect-PnPOnline -Url „https://nonexistent.sharepoint.com” -Interactive -ErrorAction Stop
# Weitere Befehle
}
catch {
Write-Error „Fehler beim Verbindungsaufbau oder Ausführung: $($_.Exception.Message)”
}
„`
Das `-ErrorAction Stop`-Flag sorgt dafür, dass ein Fehler sofort einen Abbruch im `try`-Block auslöst.

### Sichere Verwaltung von Anmeldeinformationen
Speichern Sie niemals Klartext-Passwörter oder Client-Geheimnisse direkt in Ihren Skripten. Für interaktive Anmeldungen können Sie `Get-Credential` verwenden, um Anmeldeinformationen sicher abzufragen. Für App-Secrets in automatisierten Skripten sollten Sie auf sichere Speicherorte wie Azure Key Vault zurückgreifen.

### Protokollierung
Implementieren Sie eine Protokollierung in Ihren Skripten, um den Verlauf der Operationen nachvollziehen und Fehler leichter beheben zu können. Nutzen Sie `Write-Host` für einfache Ausgaben oder `Write-Output` für die Pipeline. Für persistente Protokolle können Sie `Add-Content` oder `Out-File` verwenden.

### Modul-Updates
**PnP.PowerShell** wird regelmäßig mit neuen Funktionen und Fehlerbehebungen aktualisiert. Halten Sie Ihr Modul auf dem neuesten Stand:
„`powershell
Update-Module -Name PnP.PowerShell -Force -ErrorAction SilentlyContinue
„`

## Häufige Probleme und deren Behebung

* **Modul nicht gefunden**: Stellen Sie sicher, dass Sie `Install-Module` ausgeführt haben und PowerShell 7 als Administrator gestartet wurde. Prüfen Sie mit `Get-Module -ListAvailable`, ob es angezeigt wird. Manchmal hilft es, PowerShell nach der Installation neu zu starten.
* **Authentifizierungsfehler**: Überprüfen Sie Ihre Anmeldeinformationen, Client-IDs und Client-Geheimnisse. Stellen Sie sicher, dass die Azure AD App die korrekten API-Berechtigungen (SharePoint-Dienst) hat und dass die Administratorzustimmung erteilt wurde.
* **Berechtigung verweigert**: Auch wenn Sie sich erfolgreich angemeldet haben, können Ihnen bestimmte Aktionen aufgrund fehlender SharePoint-Berechtigungen verweigert werden. Überprüfen Sie die Berechtigungen des verwendeten Benutzers oder der App-Registrierung in SharePoint.
* **Proxy-Probleme**: In Umgebungen mit Proxy-Servern kann es zu Problemen beim Herunterladen von Modulen oder beim Verbindungsaufbau kommen. Stellen Sie sicher, dass Ihre PowerShell-Sitzung die korxy-Einstellungen korrekt verwendet.

## Fazit: Ihr Weg zur effizienten SharePoint-Verwaltung

Der Zugriff auf **SharePoint** mit **PowerShell 7** und dem **PnP.PowerShell**-Modul ist ein mächtiges Werkzeug in den Händen jedes **Admins**. Es ermöglicht Ihnen, Ihre Umgebung effizienter zu verwalten, wiederkehrende Aufgaben zu **automatisieren** und eine höhere Konsistenz in Ihren Prozessen zu erzielen.

Dieser Guide hat Ihnen die notwendigen Schritte gezeigt, von der Installation des Moduls über die verschiedenen Authentifizierungsmethoden bis hin zu grundlegenden Verwaltungsaufgaben. Nehmen Sie sich die Zeit, die Befehle zu erkunden, zu experimentieren und Ihre eigenen Skripte zu entwickeln. Die Investition in das Erlernen von **PnP.PowerShell** wird sich durch erhebliche Zeitersparnis und eine reibungslosere **SharePoint-Verwaltung** definitiv auszahlen. Beginnen Sie noch heute, die volle Leistung von PowerShell 7 für Ihre SharePoint-Umgebung zu nutzen!