Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Aktualisieren Sie eine oder mehrere Einstellungen auf Mandantenebene für SharePoint und OneDrive.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | SharePointTenantSettings.ReadWrite.All | Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | SharePointTenantSettings.ReadWrite.All | Nicht verfügbar. |
Wenn der Benutzer im Namen eines Benutzers aufruft, muss er der SharePoint-Administratorrolle angehören. Weitere Informationen zu Administratorrollen finden Sie unter Informationen zu Administratorrollen im Microsoft 365 Admin Center.
HTTP-Anforderung
PATCH /admin/sharepoint/settings
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext nur die Werte für zu aktualisierende Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.
In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| allowedDomainGuidsForSyncApp | GUID-Sammlung | Sammlung von GUIDs für vertrauenswürdige Domänen für die OneDrive-Synchronisation-App. |
| deletedUserPersonalSiteRetentionPeriodInDays | Int32 | Die Anzahl der Tage zum Beibehalten des OneDrive eines gelöschten Benutzers. |
| excludedFileExtensionsForSyncApp | String collection | Sammlung von Dateierweiterungen, die nicht von der OneDrive-Synchronisation-App hochgeladen wurden. |
| idleSessionSignOut | microsoft.graph.idleSessionSignOut | Gibt die Abmelderichtlinien für Leerlaufsitzungen für den Mandanten an. |
| imageTaggingOption | imageTaggingChoice | Gibt die Imagetaggingoption für den Mandanten an. Die möglichen Werte sind: disabled, basic, enhanced. |
| isCommentingOnSitePagesEnabled | Boolean | Gibt an, ob Kommentare auf modernen Websiteseiten in SharePoint zulässig sind. |
| isFileActivityNotificationEnabled | Boolean | Gibt an, ob Pushbenachrichtigungen für OneDrive-Ereignisse aktiviert sind. |
| isLegacyAuthProtocolsEnabled | Boolean | Gibt an, ob legacy-Authentifizierungsprotokolle für den Mandanten aktiviert sind. |
| isLoopEnabled | Boolean | Gibt an, ob Fluid Framework auf SharePoint-Websites zulässig ist. |
| isMacSyncAppEnabled | Boolean | Gibt an, ob Dateien mit der OneDrive-Synchronisation-App für Mac synchronisiert werden können. |
| isRequireAcceptingUserToMatchInvitedUserEnabled | Boolean | Gibt an, ob sich Gäste mit demselben Konto anmelden müssen, an das Freigabe-Einladungen gesendet werden. |
| isResharingByExternalUsersEnabled | Boolean | Gibt an, ob Gäste Dateien, Ordner und Websites, die sie nicht besitzen, erneut freigeben dürfen. |
| isSharePointMobileNotificationEnabled | Boolean | Gibt an, ob mobile Pushbenachrichtigungen für SharePoint aktiviert sind. |
| isSharePointNewsfeedEnabled | Boolean | Gibt an, ob der Newsfeed auf den modernen Websiteseiten in SharePoint zulässig ist. |
| isSiteCreationEnabled | Boolean | Gibt an, ob Benutzer Websites erstellen dürfen. |
| isSiteCreationUIEnabled | Boolean | Gibt an, ob die Ui-Befehle zum Erstellen von Websites angezeigt werden. |
| isSitePagesCreationEnabled | Boolean | Gibt an, ob das Erstellen neuer moderner Seiten auf SharePoint-Websites zulässig ist. |
| isSitesStorageLimitAutomatic | Boolean | Gibt an, ob der Speicherplatz des Standorts automatisch verwaltet wird oder ob bestimmte Speichergrenzwerte pro Standort festgelegt werden. |
| isSyncButtonHiddenOnPersonalSite | Boolean | Gibt an, ob die Synchronisierungsschaltfläche in OneDrive ausgeblendet ist. |
| isUnmanagedSyncAppForTenantRestricted | Boolean | Gibt an, ob Benutzer Dateien nur auf PCs synchronisieren dürfen, die mit bestimmten Domänen verknüpft sind. |
| personalSiteDefaultStorageLimitInMB | Int64 | Das Standardmäßige OneDrive-Speicherlimit für alle neuen und vorhandenen Benutzer, denen eine qualifizierende Lizenz zugewiesen ist. Gemessen in Megabyte (MB). |
| sharingAllowedDomainList | String collection | Sammlung von E-Mail-Domänen, die außerhalb des organization freigegeben werden dürfen. |
| sharingBlockedDomainList | String collection | Sammlung von E-Mail-Domänen, die für die Freigabe außerhalb des organization blockiert sind. |
| sharingCapability | sharingCapabilities | Freigabefunktion für den Mandanten. Mögliche Werte sind: disabled, externalUserSharingOnly, externalUserAndGuestSharing, existingExternalUserSharingOnly. |
| sharingDomainRestrictionMode | sharingDomainRestrictionMode | Gibt den externen Freigabemodus für Domänen an. Die möglichen Werte sind: none, allowList, blockList. |
| siteCreationDefaultManagedPath | Zeichenfolge | Der Wert des verwalteten Pfads der Teamwebsite. Dies ist der Pfad, unter dem neue Teamwebsites erstellt werden. |
| siteCreationDefaultStorageLimitInMB | Int32 | Das Standardspeicherkontingent für eine neue Website bei der Erstellung. Gemessen in Megabyte (MB). |
| tenantDefaultTimezone | Zeichenfolge | Die Standardzeitzone eines Mandanten für neu erstellte Websites. Eine Liste der möglichen Werte finden Sie unter SPRegionalSettings.TimeZones-Eigenschaft. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes Einstellungsobjekt im Antworttext zurück.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
PATCH https://graph.microsoft.com/v1.0/admin/sharepoint/settings
Content-Type: application/json
Content-length: 1323
{
"deletedUserPersonalSiteRetentionPeriodInDays": 365,
"excludedFileExtensionsForSyncApp": [".mp3"],
"imageTaggingOption": "enhanced",
"isLegacyAuthProtocolsEnabled": true,
"isSitesStorageLimitAutomatic": false,
"isSyncButtonHiddenOnPersonalSite": false,
"isUnmanagedSyncAppForTenantRestricted": false,
"personalSiteDefaultStorageLimitInMB": 120000
}
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.sharepointSettings",
"allowedDomainGuidsForSyncApp": [
"bdd1ab9b-3fd0-4def-a761-ec8d7471732c",
"ad31vb6b-5zd0-7tyg-m231-kj8d6578432c"
],
"availableManagedPathsForSiteCreation": [
"/sites/",
"/teams/"
],
"deletedUserPersonalSiteRetentionPeriodInDays": 365,
"excludedFileExtensionsForSyncApp": [
".mp3"
],
"idleSessionSignOut": {
"isEnabled": true,
"warnAfterInSeconds": 120,
"signOutAfterInSeconds": 300
},
"imageTaggingOption": "basic",
"isCommentingOnSitePagesEnabled": true,
"isFileActivityNotificationEnabled": true,
"isLegacyAuthProtocolsEnabled": true,
"isLoopEnabled": true,
"isMacSyncAppEnabled": false,
"isRequireAcceptingUserToMatchInvitedUserEnabled": true,
"isResharingByExternalUsersEnabled": true,
"isSharePointMobileNotificationEnabled": true,
"isSharePointNewsfeedEnabled": true,
"isSiteCreationEnabled": true,
"isSiteCreationUIEnabled": true,
"isSitePagesCreationEnabled": true,
"isSitesStorageLimitAutomatic": false,
"isSyncButtonHiddenOnPersonalSite": false,
"isUnmanagedSyncAppForTenantRestricted": false,
"personalSiteDefaultStorageLimitInMB": 120000,
"sharingAllowedDomainList" : [
"contoso.com",
"fabrikam.com"
],
"sharingBlockedDomainList" : [
"contoso.com",
"fabrikam.com"
],
"sharingCapability": "externalUserAndGuestSharing",
"sharingDomainRestrictionMode": "allowList",
"siteCreationDefaultManagedPath": "/sites/",
"siteCreationDefaultStorageLimitInMB": 808034,
"tenantDefaultTimezone": "(UTC-05:00) Eastern Time (US and Canada)"
}