Freigeben über

Eigenschaften des SharePoint Online-Mandanten

  • Artikel

Mit den Mandanteneigenschaften können Mandantenadministratoren Eigenschaften im App-Katalog hinzufügen, die von der Microsoft Office SharePoint-REST-API gelesen werden können.

Optionen für das Arbeiten mit Mandanteneigenschaften

Die Mandanteneigenschaften werden von Mandantenadministratoren mithilfe einer der folgenden Optionen verwaltet:

Microsoft Office SharePoint-REST-API

Hier finden Sie weitere Informationen: Microsoft Office SharePoint-REST-API

Microsoft Office SharePoint Online-Verwaltungsshell

Die Mandanteneigenschaften werden von Mandantenadministratoren mithilfe der Microsoft Office SharePoint Online-Verwaltungsshell verwaltet, die ein PowerShell-Modul von Microsoft zum Verwalten des Microsoft Office SharePoint Online-Abonnements in Office 365 darstellt.

Bevor Sie einen der „cmdlet“-Befehle im Microsoft Office SharePoint Online-Verwaltungsshell-Modul verwenden, müssen Sie zuerst mittels des „cmdlet“-Befehls Connect-SPOService eine Verbindung mit Microsoft Office SharePoint Online herstellen. Alle Mandanteneigenschaften werden mithilfe des „cmdlets“-Befehls *-SPOStorageEntity verwaltet.

Hier finden Sie weitere Informationen: Microsoft Office SharePoint Online-Verwaltungsshell

PnP PowerShell

Der Vorteil von PnP PowerShell besteht darin, dass zum Festlegen dieser Eigenschaften keine Mandantenadministratorberechtigungen erforderlich sind. Jedes Mitglied der Gruppe „Besitzer“ einer App-Katalogwebsite kann dies tun. Dies gilt sowohl für die App-Katalogwebsite des Mandanten als auch für die App-Kataloge der Websitesammlungen.

Bevor Sie einen der „cmdlet“-Befehle im PnP PowerShell-Modul verwenden, müssen Sie zuerst mittels des „cmdlet“-Befehls Connect-PnPOnline eine Verbindung mit Microsoft Office SharePoint Online herstellen. Alle Mandanteneigenschaften werden mithilfe des „cmdlets“-Befehls *-PnPStorageEntity verwaltet.

Hier finden Sie weitere Informationen: PnP PowerShell

Wichtig

Sie können mithilfe des „cmdlet“-Befehls Connect-PnPOnline mit einer beliebigen Website eine Verbindung herstellen. Wenn Sie den Parameter -Scope weglassen oder auf Tenant festlegen (den Standardwert), gelten alle „cmdlet“-Befehle für den Mandanten-App-Katalog, unabhängig von der Website, mit der Sie eine Verbindung hergestellt haben. Wenn Sie den Parameter „-Scope“ auf „Site“ festlegen, werden alle „cmdlet“-Befehle auf den Websitesammlungs-App-Katalog der Website angewendet, mit der Sie eine Verbindung hergestellt haben.

Hinweis

PnP PowerShell ist eine Open Source-Lösung mit aktiver Community, die Support dafür bietet. Es gibt keine SLA für den Support des Open-Source-Tools durch Microsoft.

CLI für Microsoft 365

Die CLI für Microsoft 365 kann zum Verwalten der Mandanteneigenschaften verwendet werden. Die CLI für Microsoft 365 ist eine plattformübergreifende Befehlszeilenschnittstelle, die auf einer beliebigen Plattform verwendet werden kann, darunter Windows, macOS und Linux.

Bevor Sie einen der Befehle in der CLI für Microsoft 365 verwenden, müssen Sie mit Ihrem Microsoft 365-Mandanten zuerst über den Befehl m365 login eine Verbindung herstellen. Alle Microsoft Office SharePoint Online-Mandanteneigenschaften werden mithilfe des Befehls spo storageentity verwaltet.

Hier finden Sie weitere Informationen: CLI für Microsoft 365

Wichtig

Mandanteneigenschaften sind auf der mit dem jeweiligen Mandanten verknüpften App-Katalogwebsite gespeichert. Zum Festlegen oder Entfernen einer Eigenschaft müssen Sie die absolute URL der App-Katalogwebsite angeben. Wenn Sie die URL einer anderen Website als die des App-Katalogs angeben, wird die Fehlermeldung angezeigt, dass der Zugriff verweigert wurde.

Hinweis

Die CLI für Microsoft 365 ist eine Open-Source-Lösung mit aktiver Community, die Support dafür bietet. Es gibt keine SLA für den Support des Open-Source-Tools durch Microsoft.

Mandanteneigenschaften auflisten

Die folgenden Optionen veranschaulichen, wie Sie Mandanteneigenschaften aus Microsoft Office SharePoint Online auflisten.

Anforderung

GET https://tenant.sharepoint.com/sites/site/_api/web/AllProperties?$select=storageentitiesindex

Antwort

HTTP/1.1 200 OK
Content-Type: application/json
{
  "key": {
    "Comment":"Tenant property comment.",
    "Description":"Tenant property description",
    "Value":"Tenant property key value"
  }
}

Abrufen/Schreiben von Mandanteneigenschaften

Die folgenden Optionen veranschaulichen, wie Sie Mandanteneigenschaften aus Microsoft Office SharePoint Online abrufen.

Anforderung

GET https://tenant.sharepoint.com/sites/site/_api/web/GetStorageEntity('key')

Antwort

HTTP/1.1 200 OK
Content-Type: application/json
{
  "Comment":"Tenant property comment.",
  "Description":"Tenant property description",
  "Value":"Tenant property key value"
}

Frestlegen/Schreiben von Mandanteneigenschaften

Die folgenden Optionen veranschaulichen, wie Sie Mandanteneigenschaften aus Microsoft Office SharePoint Online schreiben.

Nicht unterstützt

Entfernen von Mandanteneigenschaften

Die folgenden Optionen veranschaulichen, wie Sie Mandanteneigenschaften aus Microsoft Office SharePoint Online entfernen.

Nicht unterstützt

Benutzerdefinierte Skript- und Websitesammlungs-App-Kataloge

Es ist nur erlaubt, Mandanteneigenschaften für Websitesammlungs-App-Kataloge in Websites festzulegen, bei denen benutzerdefinierte Skripts aktiviert sind. Wenn Sie versuchen, eine Mandanteneigenschaft in einer „No-Script-Website“ festzulegen, wird der folgende Fehler angezeigt:

Access denied. You do not have permission to perform this action or access this resource.

Weitere Informationen zu benutzerdefinierten Skripts finden Sie unter: Zulassen oder Verhindern benutzerdefinierter Skripts.

Die Fehlermeldung wird auch angezeigt, wenn Sie nicht Eigentümer oder Websitesammlungs-Administrator der Website sind.

Siehe auch