Installieren einer SharePoint Embedded-App

Gilt für: Nutzen des Mandantenadministrators – SharePoint Embedded-Administrator/globaler Administrator

Installieren Sie eine SharePoint Embedded-App, wenn ein Microsoft 365-Mandant die App verwenden muss.

Die Installation macht die App für die Mandantenverwaltung sichtbar, aber der Mandant benötigt möglicherweise weiterhin die Administratoreinwilligung, die Registrierung von Containertypberechtigungen und die Abrechnung, bevor Benutzer auf Inhalte zugreifen können.

Dieser Artikel konzentriert sich auf den Administratorpfad für den Verbrauch von Mandanten im SharePoint Admin Center.

Wichtig

Ein Nutzen des Mandantenadministrators ist in der Regel ein Benutzer, dem die SharePoint Embedded-Administratorrolle zugewiesen ist. Globale Administratoren können auch SharePoint Embedded-Verwaltungsaufgaben ausführen.

Verwenden Sie diesen Artikel mit Auswählen eines App-Modells: Single-Tenant oder mehrinstanzenfähig und dem Leitfaden zur App-Erstellung.

Das App-Modell bestimmt, wer die App besitzt, wer sie installiert oder integriert, wo Container erstellt werden, wer bezahlt und welche Administratoren die Abrechnung zustimmen oder konfigurieren müssen.

Bevor Sie beginnen

Bestätigen Sie diese Voraussetzungen.

Sie können sich beim nutzenden Mandanten anmelden.
Ihr Konto verfügt über die Rolle "SharePoint Embedded-Administrator" oder "Globaler Administrator".
Die SharePoint Embedded-App ist im besitzenden Mandanten vorhanden.
Sie verfügen über den Vom App-Besitzer bereitgestellten App-Identitäts- oder Installationslink.
Sie wissen, ob die Abrechnung vom App-Besitzer oder vom Benutzer organization erfolgt.
Sie wissen, welche Berechtigungen die App anfordert.
Sie können die Administratoreinwilligung abschließen, wenn dies für den Installationsablauf erforderlich ist.
Sie wissen, ob es sich bei der App um eine branchenspezifische App mit einem Mandanten oder um eine mehrinstanzenfähige ISV-App handelt.

Rolleninformationen finden Sie unter Admin Übersicht.

Grundlegendes zum Nutzen des Mandantenpfads

Ein Nutzungsmandant ist der Microsoft 365-Mandant, in dem Benutzer die SharePoint Embedded-App ausführen und in dem die App Inhalte in Containern speichert.

Der Nutzen des Mandantenadministrators verwaltet die App und die Container in diesem Mandanten.

Bei einer branchenspezifischen App mit nur einem Mandanten sind der besitzernde und der nutzende Mandant in der Regel identisch.

Bei einer mehrinstanzenfähigen ISV-App ist jeder Kundenmandant ein nutzungsintensiver Mandant, und Kundendateien verbleiben in der Microsoft 365-Mandantengrenze des Kunden.

Mandantenadministratoren verwenden zwei Verwaltungsoberflächen.

Surface	Verwenden Sie es für
SharePoint Admin Center	Zeigen Sie installierte Apps, aktive Container, gelöschte Container und Containerdetails an.
SharePoint Online-Verwaltungsshell	Auflisten von Anwendungen, Auflisten von Containern, Aktualisieren von Bezeichnungen, Konfigurieren der Freigabe und Verwalten von Lebenszyklusvorgängen

Verwenden Sie das SharePoint Admin Center, wenn Sie eine geführte Installation und Überprüfung benötigen.

Verwenden Sie PowerShell für wiederholbare Inventur und Vorgänge nach der Installation.

Installieren aus dem SharePoint Admin Center

Verwenden Sie die SharePoint Embedded Apps-Benutzeroberfläche im SharePoint Admin Center, wenn die App installiert werden kann.

Auf der Registerkarte Installierte Apps werden SharePoint Embedded-Apps aufgelistet, die von Ihrem organization und von externen Organisationen erstellt wurden. Es enthält derzeit keine von Microsoft erstellten SharePoint Embedded-Apps.

Melden Sie sich beim SharePoint Admin Center an.
Erweitern Sie im linken Navigationsbereich SharePoint Embedded.
Wählen Sie Apps aus.
Überprüfen Sie Installierte Apps , um zu überprüfen, ob die App bereits installiert ist.
Wenn Sie besitzer der App sind, lesen Sie Eigene Apps , und suchen Sie die App.
Wählen Sie die verfügbare Installationsaktion für die App aus.
Überprüfen Sie den App-Namen, den Herausgeber und die Abrechnungsinformationen.
Fahren Sie mit den Installationsaufforderungen fort.
Schließen Sie die Administratoreinwilligung ab, wenn sie durch den Flow zur Zustimmung aufgefordert werden.
Schließen Sie die Installation ab.

Die genauen Installationsaufforderungen können je nach App-Besitz und Abrechnungsmodell variieren.

Fahren Sie nicht fort, wenn die App-Identität oder der Herausgeber unerwartet ist.

Achtung

Installieren Sie nur Apps, denen Ihr organization vertraut. Eine SharePoint Embedded-App kann Container gemäß den gewährten Berechtigungen erstellen und darauf zugreifen.

Installieren einer eigenen App, die nicht installiert wurde

Bei einem erfolgreichen Erstellungsflow wird die App automatisch installiert, sodass Sie in der Regel keine eigene App separat installieren.

Nur wenn der Installationsschritt im Erstellungsflow fehlschlägt, wird die SharePoint Embedded-App erstellt, aber nicht installiert.

Installieren Sie in diesem Fall die App über die Registerkarte Eigene Apps .

Wechseln Sie zu SharePoint Embedded>Apps.
Öffnen Sie im Besitz befindliche Apps.
Suchen Sie die App, die nicht installiert ist.
Wählen Sie die Installationsaktion für die App aus.
Führen Sie die Installationsaufforderungen aus.

Nach Abschluss der Installation wird die App auf der Registerkarte Installierte Apps angezeigt.

Überprüfen der Installation

Überprüfen Sie nach der Installation den App-Bestand.

Kehren Sie zu SharePoint Embedded>Apps zurück.
Öffnen Sie Installierte Apps.
Vergewissern Sie sich, dass die App aufgeführt ist.
Bestätigen Sie den App-Namen und den Herausgeber.
Bestätigen Sie den Abrechnungstyp und status.
Wenn sich die App im Besitz Ihres organization befindet, öffnen Sie eigene Apps, und bestätigen Sie die Besitzmetadaten.
Notieren Sie sich die besitzende Anwendungs-ID für zukünftige PowerShell- und Berechtigungsüberprüfungen.

Wählen Sie auf der Registerkarte Installierte Apps eine App aus, um den Detailbereich zu öffnen. Im Bereich werden die status der App, Entra App-ID, SharePoint Embedded-App-ID, Herausgeber und Abrechnungsinformationen angezeigt.

App-Detailbereich für eine installierte App mit einer aktiven status, der Entra App-ID, der SharePoint Embedded-App-ID, dem Herausgeber und Abrechnungsinformationen, die abrechnungs- status, Azure Abonnement-ID, Ressourcengruppe und Abrechnungstyp enthalten.

Abbildung 1: Im Bereich "App-Details" auf der Registerkarte "Installierte Apps" werden Bezeichner und Abrechnungsinformationen angezeigt, und Sie können die Entra- und SharePoint Embedded-App-IDs kopieren.

Wenn die App nicht sichtbar ist, aktualisieren Sie die Seite, und vergewissern Sie sich, dass die Installation erfolgreich abgeschlossen wurde.

Wenn die App weiterhin fehlt, wenden Sie sich an den App-Besitzer, und überprüfen Sie die App-Identität.

Installation und Zustimmung hängen zusammen, aber nicht immer die gleiche Aufgabe.

Für die besitzende App muss ein Dienstprinzipal im nutzenden Mandanten und die Administratoreinwilligung installiert sein, bevor sie Anwendungsberechtigungen vom Typ Container registrieren kann.

Hinweis

Wenn Sie die App im SharePoint Admin Center erstellen, wird die Zustimmung im Rahmen des Erstellungsflows erteilt, sodass Sie den Schritt zur manuellen Administratoreinwilligung in diesem Abschnitt nicht ausführen. Verwenden Sie diesen Abschnitt, wenn die App auf andere Weise erstellt wird, z. B. eine App, die ein anderer organization besitzt, oder eine App, die direkt in Microsoft Entra registriert ist.

Verwenden Sie Erteilen der Administratoreinwilligung und -berechtigungen , um die angeforderten Berechtigungen zu überprüfen und die Zustimmung abzuschließen.

Admin Zustimmung kann über den Endpunkt für die Microsoft Identity Platform Administratoreinwilligung angefordert werden, z. B.:

https://login.microsoftonline.com/{your-tenant-id}/v2.0/adminconsent?client_id={owning-app-clientid}&scope=https://graph.microsoft.com/.default&redirect_uri={spe-app-redirect-uri}

Verwenden Sie die genaue Client-ID, die vom App-Besitzer bereitgestellt wird. Ersetzen Sie keine andere Anwendungs-ID.

Bestätigen der Abrechnungsanforderungen

SharePoint Embedded unterstützt Standard- und Passthrough-Abrechnungsmodelle.

Für die Passthrough-Abrechnung muss ein globaler Administrator im nutzenden Mandanten die Abrechnung im Microsoft 365 Admin Center einrichten, bevor Benutzer auf die App zugreifen können. Nur ein globaler Administrator kann die Abrechnung einrichten. die SharePoint Embedded-Administratorrolle kann dies nicht.

Wenn die Abrechnung ungültig ist oder SharePoint Embedded deaktiviert ist, können Benutzer keine neuen Container mehr erstellen, obwohl auf vorhandene Container und deren Inhalte weiterhin zugegriffen werden kann.

Anfügen oder Ändern der Abrechnung über den Detailbereich

Wenn die Abrechnung während der App-Erstellung übersprungen wurde, können Sie sie später im Bereich mit den App-Details auf der Registerkarte Installierte Apps anfügen. Für eine Besitzer-Organisations-App, die Ihrem organization gehört, können Sie auch das Abrechnungsabonnement ändern, das bereits im selben Bereich angefügt ist.

Öffnen Sie Installierte SharePoint Embedded>Apps-Apps>.
Wählen Sie die App aus, um den Detailbereich zu öffnen.
Fügen Sie unter Abrechnungsinformationen ein Abrechnungsabonnement an, oder aktualisieren Sie das vorhandene Abonnement.

Für eine Benutzer-Organisations-App wird die Abrechnung nicht über diesen Bereich angefügt. Ein globaler Administrator im verbrauchenden Mandanten richtet die Abrechnung im Microsoft 365 Admin Center ein. Weitere Informationen finden Sie unter Einrichten der Abrechnung in Microsoft 365 Admin Center.

Verwenden Sie Abrechnung einrichten in Microsoft 365 Admin Center, um die Abrechnung für Szenarien mit Nutzungsmandanten zu konfigurieren.

Verwenden Sie Nutzung, Abrechnung und Kosten überwachen, um die laufenden Kosten zu überprüfen.

Überprüfen von Containern nach der App-Verwendung

Die App erstellt möglicherweise erst Dann Container, wenn Benutzer oder App-Prozesse sie verwenden. Nachdem Container vorhanden sind, überprüfen Sie sie.

Navigieren Sie im SharePoint Admin Center zu SharePoint Embedded>Active Containers.
Suchen oder filtern Sie nach Anwendungsname.
Öffnen Sie einen Bereich mit Containerdetails.
Überprüfen Sie allgemeine Metadaten.
Mitgliedschaft überprüfen.
Bestätigen Sie den Status der Vertraulichkeitsbezeichnung, wenn Bezeichnungen erforderlich sind.
Überprüfen Sie die Speichernutzung.

Ausführliche Schritte finden Sie unter Verwalten von Containern im SharePoint Admin Center.

Überprüfen mit PowerShell

Verwenden Sie SharePoint Online-Verwaltungsshell, wenn Sie eine skriptbasierte Überprüfung benötigen.

Installieren Sie die neueste SharePoint Online-Verwaltungsshell, und stellen Sie eine Verbindung mit SharePoint Online her.

Verwenden Sie dann die unterstützten Anwendungsinventur-Cmdlets.

Get-SPOApplication

Um Details für eine bestimmte Anwendung anzuzeigen, verwenden Sie die id der besitzenden Anwendung.

Get-SPOApplication -OwningApplicationId <OwningApplicationId>

Befehlsdetails finden Sie unter Verwalten von Containern mit PowerShell und Get-SPOApplication.

Verwalten von Containertypregistrierungen mit Microsoft Graph

Mandantenadministratoren können Containertypregistrierungen auch programmgesteuert verwalten. Die FileStorageContainerTypeRegistration-Ressource stellt die Registrierung eines Containertyps in einem verbrauchenden Mandanten dar. Für die Verwaltung aller Registrierungen im Mandanten ist die FileStorageContainerTypeReg.Manage.All delegierte Berechtigung erforderlich.

Vorgang	API
Registrierungen auflisten	Auflisten von Containertypregistrierungen
Registrierung abrufen	Abrufen der Containertypregistrierung
Aktualisieren einer Registrierung	Aktualisieren der Containertypregistrierung
Löschen einer Registrierung	Containertypregistrierung löschen

Problembehandlung bei der Installation

Verwenden Sie diese Überprüfungen, wenn die Installation nicht abgeschlossen ist.

Vergewissern Sie sich, dass der Administrator über die SharePoint Embedded-Administratorrolle verfügt.
Bestätigen Sie die App-Identität und den Herausgeber.
Vergewissern Sie sich, dass die App für Ihren Mandanten verfügbar ist.
Vergewissern Sie sich, dass die Administratoreinwilligung für die richtige Anwendung erteilt wurde.
Vergewissern Sie sich nach der Zustimmung, dass die App über einen Dienstprinzipal im Nutzen des Mandanten verfügt.
Vergewissern Sie sich, dass die Abrechnung für Passthrough-Apps aktiv ist.
Bestätigen Sie bei Bedarf die Anwendungsberechtigungen des App-Besitzers für den registrierten Containertyp.
Vergewissern Sie sich, dass Benutzern die erforderlichen App-Rollen oder Mitgliedschaften zugewiesen sind.