M365Con 2027 – die kostenlose Online-Konferenz · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Mit PnP PowerShell eine Verbindung zu SharePoint Online herstellen: Anmeldeoptionen

Von · · Aktualisiert

Verbindung zu SharePoint Online mit PnP PowerShell herstellen: Registrieren Sie eine eigene Entra-App und wählen Sie dann je Aufgabe die interaktive Anmeldung, die Geräteanmeldung, die Zertifikatsanmeldung oder eine verwaltete Identität.

Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen

Um heute mit PnP PowerShell eine Verbindung zu SharePoint Online herzustellen, registrieren Sie einmalig eine eigene App in Microsoft Entra ID. Anschließend rufen Sie Connect-PnPOnline mit Ihrer Website-URL und der Client-ID dieser App auf, dazu eine Anmeldemethode: interaktiv, Geräteanmeldung, Zertifikat, verwaltete Identität oder die veralteten Anmeldedaten. Dieser Leitfaden richtet sich an SharePoint-Administratoren, die Skripte manuell oder nach Zeitplan ausführen. Er erklärt, was jede Option bewirkt, wann Sie sie einsetzen und welche Fehler eine Verbindung scheitern lassen. Außerdem zeigt er, wie Sie je Aufgabe genau eine Option wählen, damit ein Skript nicht mehr Zugriff erhält, als seine Aufgabe erfordert.

Das Wichtigste in Kürze

  • Seit dem 9. September 2024 benötigt Connect-PnPOnline eine -ClientId. Deshalb muss jeder Administrator zuerst eine App in Microsoft Entra ID registrieren, mit der sich das Modul anmelden kann.
  • Die interaktive Anmeldung ist die richtige Wahl für eine Person am Rechner, denn sie unterstützt die Multi-Faktor-Authentifizierung und benötigt kein gespeichertes Geheimnis.
  • Unbeaufsichtigte Aufgaben sollten die Zertifikatsanmeldung oder eine verwaltete Identität verwenden, nicht ein eingegebenes Kennwort und nicht ein im Skript gespeichertes Clientgeheimnis.
  • Die veraltete Methode mit dem Clientgeheimnis funktioniert nur für SharePoint-Cmdlets. Jeder Befehl, der Microsoft Graph aufruft, schlägt damit daher fehl.
  • Registrieren Sie die App nur mit den delegierten Berechtigungen, die Sie benötigen, denn die Standardregistrierung fordert weitreichende Rechte an, etwa AllSites.FullControl.

Einstieg: Warum jede Verbindung eine eigene App benötigt

PnP PowerShell ist ein von der Community gepflegtes Modul. Es verfügt über keine eigenen besonderen Rechte. Jede Anmeldung läuft über eine App-Registrierung in Microsoft Entra, und diese App legt fest, was das Skript darf.

Laut der Referenz zu Connect-PnPOnline müssen Sie ab dem 9. September 2024 den Parameter -ClientId angeben. Außerdem müssen Sie zuerst eine eigene App registrieren. Statt die ID bei jedem Aufruf einzugeben, können Sie die Umgebungsvariable ENTRAID_APP_ID oder ENTRAID_CLIENT_ID setzen.

Das betrifft ältere Skripte. Wenn ein Skript aus dem Jahr 2023 nur Connect-PnPOnline -Url ... -Interactive aufruft, schlägt es jetzt fehl oder fragt nach einer fehlenden Client-ID. Die Lösung liegt nicht in der Logik des Skripts. Sie benötigen eine App und eine ID.

Zwei weitere Werte tauchen in jedem Beispiel auf:

  • -Url ist die Adresse der Website, mit der Sie arbeiten möchten, etwa https://contoso.sharepoint.com/sites/finance. Für die meisten Methoden ist er erforderlich.
  • -Tenant ist der Name des Mandanten, etwa contoso.onmicrosoft.com. Laut Referenz ist er für die Zertifikats- und Fingerabdruckmethoden erforderlich. Für die interaktive Anmeldung und die Geräteanmeldung ist er optional.

Wenn ein Befehl das SharePoint Admin Center benötigt, können Sie -TenantAdminUrl übergeben. Lassen Sie den Parameter weg, nehmen die Cmdlets dort, wo es zutrifft, die Form https://[tenantname]-admin.sharepoint.com an.

Schritt 1: Die App-Registrierung in Microsoft Entra abschließen

Dieser Einstieg setzt voraus, dass das Modul PnP.PowerShell bereits auf Ihrem Computer installiert ist. PnP bietet einen Helfer für die Ersteinrichtung. Die Cmdlet-Seite zu Register-PnPEntraIDAppForInteractiveLogin zeigt die kürzeste Form:

Register-PnPEntraIDAppForInteractiveLogin -ApplicationName TestApp -Tenant yourtenant.onmicrosoft.com

Ein Browserfenster öffnet sich, damit Sie sich anmelden können, und das Cmdlet erstellt die App. Außerdem gibt es die Anwendungs-ID aus, die Sie als -ClientId verwenden. Fügen Sie -DeviceLogin hinzu, wenn Sie auf dem Computer keinen Browser öffnen können. Laut der Seite wechselt das auf einen Gerätecode-Anmeldablauf, der Multi-Faktor-Authentifizierung unterstützt.

Achten Sie auf die Berechtigungen. Im einfachen Beispiel fordert die App folgende delegierte Berechtigungen zur Zustimmung an: AllSites.FullControl, Group.ReadWrite.All, User.ReadWrite.All und TermStore.ReadWrite.All. Das zweite Beispiel auf derselben Seite schränkt dies ein, mit -GraphDelegatePermissions "Group.Read.All" und -SharePointDelegatePermissions "AllSites.FullControl".

Das ist für das Prinzip der minimalen Berechtigungen wichtig. Ein Berichtsskript, das nur liest, braucht keine Schreibrechte für Benutzer und Gruppen. Legen Sie fest, was Ihre Skripte benötigen, und fordern Sie nur das an.

Halten Sie für jede App-Registrierung fest: Name, Client-ID, Eigentümer und die enthaltenen Berechtigungen. Überprüfen Sie die App-Registrierung einmal im Jahr, und löschen Sie sie, sobald kein Skript sie mehr verwendet.

Zwei Einschränkungen sollten Sie kennen. Die Referenzseite nennt nicht, welche Entra-Rolle Sie zum Registrieren einer App benötigen. Fragen Sie deshalb Ihren Identity-Administrator, bevor Sie beginnen. Der Parameter -SignInAudience legt fest, welche Kontotypen die App unterstützt. Prüfen Sie, ob er zu Ihrem Mandanten passt.

So verbinden Sie sich mit PnP PowerShell mit SharePoint Online: die fünf Optionen

Alle fünf Beispiele stützen sich auf die Referenz zu Connect-PnPOnline. Ersetzen Sie die Werte in spitzen Klammern.

Interaktive Anmeldung

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -Interactive -ClientId <appId>

Das ist die Standardwahl für eine Person. Laut Referenz ist diese Methode für Multi-Faktor-Authentifizierung ausgelegt. Fügen Sie -ForceAuthentication hinzu, um gespeicherte Authentifizierungsdaten zu verwerfen und sich mit einem anderen Konto anzumelden. Verwenden Sie das, wenn Sie zwischen einem Test- und einem Produktionsmandanten wechseln.

Gerätecodeanmeldung

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -DeviceLogin -ClientId <appId>

Ein Browser öffnet sich, und der Code wird in Ihre Zwischenablage kopiert. Wählen Sie diese Option, wenn die Shell in einer Remotesitzung läuft, in der ein interaktives Fenster nicht gut funktioniert.

Zertifikatsanmeldung (nur App)

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -ClientId <appId> -Tenant 'contoso.onmicrosoft.com' -Thumbprint <thumbprint>

Keine Person meldet sich an. Die App handelt eigenständig mit den Anwendungsberechtigungen, die Sie ihr gegeben haben. Sie können -CertificatePath zusammen mit -CertificatePassword übergeben, einen -CertificateBase64Encoded-Wert oder einen -Thumbprint. Die Thumbprint-Methode benötigt das Zertifikat im Windows-Zertifikatspeicher. Das ist die Standardwahl für unbeaufsichtigte Skripte auf einem Server.

Verwaltete Identität

Connect-PnPOnline -Url "https://contoso.sharepoint.com" -ManagedIdentity

Laut Referenz funktioniert das nur in Umgebungen, die verwaltete Identitäten unterstützen, etwa Azure Functions, Automation-Runbooks und Cloud Shell. Sie speichern dabei gar kein Geheimnis. Für eine benutzerzugewiesene Identität fügen Sie eines von -UserAssignedManagedIdentityClientId, -UserAssignedManagedIdentityObjectId oder -UserAssignedManagedIdentityAzureResourceId hinzu. Der Parameter -Url ist bei dieser Methode optional.

Anmeldeinformationen und Clientgeheimnisse

Zwei ältere Methoden gibt es noch, und beide sind mit Warnhinweisen versehen.

  • -Credentials erwartet ein PSCredential, zum Beispiel (Get-Credential), oder den Namen eines generischen Anmeldeinformationseintrags im Windows-Anmeldeinformationsspeicher. Die Referenz nennt Multi-Faktor-Unterstützung für die interaktive und die Gerätecodeanmeldung, behauptet das hier jedoch nicht. Betrachten Sie diese Option als Lösung für Konten ohne Eingabeaufforderung, und testen Sie sie, bevor Sie sich darauf verlassen.
  • -ClientSecret zusammen mit -ClientId ist die veraltete ACS-Methode. Laut Referenz gilt damit: „nur Cmdlets, die eine Verbindung mit SharePoint Online herstellen, funktionieren.“ Cmdlets, die Microsoft Graph verwenden, schlagen fehl.

Verwenden Sie beides nicht für neue Vorhaben. Ein Kennwort in einem Skript ist ein Risiko, und ein Clientgeheimnis läuft ohne Vorwarnung ab.

Beispiel: Auswahl einer Anmeldeoption für vier Aufgaben

Die folgenden Zahlen und Namen sind erfunden und dienen nur der Veranschaulichung.

Ein Administratorteam in einem fiktiven Unternehmen betreibt vier Aufgaben. Das Team möchte pro Risikostufe eine App einsetzen und nicht eine einzige App für alles.

  1. Ad-hoc-Prüfungen durch einen Administrator am Laptop. Verwenden Sie -Interactive mit einer App, die nur eng begrenzte delegierte Berechtigungen besitzt. Der Administrator meldet sich mit MFA an. Es wird nichts gespeichert.
  2. Eine einmalige Bereinigung auf einem entfernten Jump-Server. Verwenden Sie -DeviceLogin. Der Administrator schließt die Anmeldung auf einem Telefon oder Laptop ab, danach startet die Ausführung.
  3. Eine nächtliche Bestandsaufnahme auf einem Windows-Server. Verwenden Sie ein Zertifikat mit -Thumbprint. Die App besitzt nur Leseberechtigungen für Anwendungen. Das Zertifikat ist 12 Monate gültig, und das Team trägt den Erneuerungstermin in einen gemeinsamen Kalender ein.
  4. Ein wöchentlicher Auftrag in einem Automation-Runbook. Verwenden Sie -ManagedIdentity. Es gibt kein Zertifikat und kein Geheimnis, das rotiert werden muss.

Das Ergebnis: Nur Aufgabe 1 und Aufgabe 2 sind von einer Person abhängig. Die Aufgaben 3 und 4 laufen ohne Beteiligung einer Person, und keine der beiden speichert ein Kennwort. Wird der Server aus Aufgabe 3 gestohlen, widerruft das Team ein einziges Zertifikat. Ein Administratorkennwort muss es nicht zurücksetzen.

Welche Option Sie auch wählen: Halten Sie die Website-URL in einer Variablen wie $siteUrl vor. So kann ein einzelnes PowerShell-Skript eine Liste von Websites durchlaufen, für jede SharePoint-Website die benötigten Daten abrufen und einen Bericht hochladen. Testen Sie das Skript zuerst mit einer einzelnen Websitesammlung, bevor Sie es über Ihren gesamten Microsoft-365-Mandanten ausführen.

Häufige Fehler

  • Vergessen von -ClientId. Die Verbindung schlägt fehl oder fordert die ID an. Speichern Sie die ID auf Rechnern, auf denen Sie häufig Skripte ausführen, in der Umgebungsvariable ENTRAID_APP_ID.
  • Eine einzige, allmächtige App für alles verwenden. Die Standardregistrierung fordert AllSites.FullControl sowie Schreibzugriff auf Benutzer und Gruppen an. Registrieren Sie eine zweite, rein lesende App für Berichte.
  • Ein Clientgeheimnis mit Graph-basierten Cmdlets verwenden. Die veraltete Methode funktioniert nur für SharePoint-Cmdlets. Ruft ein Befehl Graph auf, schlägt er fehl, und die Fehlermeldung kann verwirrend sein.
  • Ein Kennwort oder Geheimnis in der Skriptdatei hinterlegen. Jeder mit Leserechten auf die Datei besitzt die Anmeldedaten. Verwenden Sie stattdessen einen Zertifikatspeicher oder eine verwaltete Identität.
  • Die Anmeldung in der Zielumgebung nicht testen. Ein Skript, das auf Ihrem Laptop mit -Interactive funktioniert, kann auf einem Server ohne Browser fehlschlagen. Testen Sie mit der Methode, die die Aufgabe tatsächlich verwenden wird.
  • Beim falschen Mandanten angemeldet bleiben. Verwenden Sie -ForceAuthentication, wenn Sie das Konto wechseln, und geben Sie zu Beginn jedes Skripts die Verbindungsdetails aus.

Wie Software helfen kann

Beginnen Sie mit dem, was Sie bereits haben. Das PnP-Modul und das Microsoft Graph PowerShell SDK decken den größten Teil der administrativen Skriptarbeit ab. Azure Automation führt Skripte nach einem Zeitplan mit einer verwalteten Identität aus, und das SharePoint Admin Center zeigt Websites und Einstellungen ohne Code an. Für Geheimnisse sind ein Zertifikatspeicher oder ein Key Vault sicherer als eine Skriptdatei.

Ergänzen Sie außerdem Berichterstellung. Ein Skript, das sich korrekt verbindet, ist nur der erste Schritt. Teams brauchen außerdem ein klares Protokoll darüber, was jedes Skript geändert hat und welche App-Identität es verwendet hat, damit der nächste Administrator den Ablauf nachvollziehen kann. Bewahren Sie dieses Protokoll an einem Ort auf, den alle lesen können, etwa in einer gemeinsamen Liste oder einem Ticketsystem.

Nächster Schritt

Registrieren Sie noch heute eine App mit dem kleinsten Satz delegierter Berechtigungen, den Ihre Skripte benötigen. Testen Sie anschließend, ob Sie mit PnP PowerShell und -Interactive eine Verbindung zu SharePoint Online herstellen können, und notieren Sie, welche Anmeldeoption jede Ihrer geplanten Aufgaben verwenden wird.

Show folgenSpotify

Entitäten in diesem Artikel

PnP PowerShell Microsoft Entra PowerShell SharePoint

Verwandte Artikel

RSS