名前空間: microsoft.graph
SharePoint と OneDrive の 1 つ以上のテナント レベル の設定 を更新します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
| ✅ |
✅ |
✅ |
❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。
アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 |
最小特権アクセス許可 |
より高い特権のアクセス許可 |
| 委任 (職場または学校のアカウント) |
SharePointTenantSettings.ReadWrite.All |
注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) |
サポートされていません。 |
サポートされていません。 |
| アプリケーション |
SharePointTenantSettings.ReadWrite.All |
注意事項なし。 |
ユーザーの代わりにを呼び出す場合、ユーザーは SharePoint 管理者ロールに属している必要があります。 管理者ロールの詳細については、「Microsoft 365 管理センターの管理者ロールについて」を参照してください。
HTTP 要求
PATCH /admin/sharepoint/settings
| 名前 |
説明 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
| Content-Type |
application/json. 必須です。 |
要求本文
要求本文で、更新するプロパティの値 のみを 指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。
次の表に、更新できるプロパティを示します。
| プロパティ |
型 |
説明 |
| allowedDomainGuidsForSyncApp |
GUID コレクション |
OneDrive 同期 アプリの信頼されたドメイン GUID のコレクション。 |
| deletedUserPersonalSiteRetentionPeriodInDays |
Int32 |
削除されたユーザーの OneDrive を保持するための日数。 |
| excludedFileExtensionsForSyncApp |
String collection |
OneDrive 同期 アプリによってアップロードされていないファイル拡張子のコレクション。 |
| idleSessionSignOut |
microsoft.graph.idleSessionSignOut |
テナントのアイドル セッション サインアウト ポリシーを指定します。 |
| imageTaggingOption |
imageTaggingChoice |
テナントのイメージタグ付けオプションを指定します。 使用可能な値: disabled、basic、enhanced。 |
| isCommentingOnSitePagesEnabled |
ブール型 |
SharePoint のモダン サイト ページでコメントを許可するかどうかを示します。 |
| isFileActivityNotificationEnabled |
ブール型 |
OneDrive イベントに対してプッシュ通知が有効かどうかを示します。 |
| isLegacyAuthProtocolsEnabled |
ブール型 |
テナントに対してレガシ認証プロトコルが有効になっているかどうかを示します。 |
| isLoopEnabled |
ブール型 |
SharePoint サイトで Fluid Framework が許可されているかどうかを示します。 |
| isMacSyncAppEnabled |
ブール型 |
mac 用OneDrive 同期 アプリを使用してファイルを同期できるかどうかを示します。 |
| isRequireAcceptingUserToMatchInvitedUserEnabled |
ブール型 |
ゲストが、共有の招待が送信されるのと同じアカウントを使用してサインインする必要があるかどうかを示します。 |
| isResharingByExternalUsersEnabled |
ブール型 |
ゲストが所有していないファイル、フォルダー、サイトを再共有できるかどうかを示します。 |
| isSharePointMobileNotificationEnabled |
ブール型 |
モバイル プッシュ通知が SharePoint に対して有効になっているかどうかを示します。 |
| isSharePointNewsfeedEnabled |
ブール型 |
SharePoint のモダン サイト ページでニュースフィードを許可するかどうかを示します。 |
| isSiteCreationEnabled |
ブール型 |
ユーザーがサイトの作成を許可されているかどうかを示します。 |
| isSiteCreationUIEnabled |
ブール型 |
サイトを作成するための UI コマンドを表示するかどうかを示します。 |
| isSitePagesCreationEnabled |
ブール型 |
SharePoint サイトで新しいモダン ページの作成を許可するかどうかを示します。 |
| isSitesStorageLimitAutomatic |
ブール型 |
サイトのストレージ領域が自動的に管理されるかどうか、またはサイトごとに特定のストレージ制限が設定されているかどうかを示します。 |
| isSyncButtonHiddenOnPersonalSite |
ブール型 |
OneDrive の同期ボタンが非表示かどうかを示します。 |
| isUnmanagedSyncAppForTenantRestricted |
ブール型 |
ユーザーが特定のドメインに参加している PC でのみファイルを同期できるかどうかを示します。 |
| personalSiteDefaultStorageLimitInMB |
Int64 |
対象となるライセンスが割り当てられているすべての新規ユーザーと既存ユーザーの既定の OneDrive ストレージ制限。 メガバイト (MB) 単位で測定されます。 |
| sharingAllowedDomainList |
String collection |
organizationの外部で共有できる電子メール ドメインのコレクション。 |
| sharingBlockedDomainList |
String collection |
organizationの外部で共有するためにブロックされている電子メール ドメインのコレクション。 |
| sharingCapability |
sharingCapabilities |
テナントの共有機能。 使用可能な値: disabled、externalUserSharingOnly、externalUserAndGuestSharing、existingExternalUserSharingOnly。 |
| sharingDomainRestrictionMode |
sharingDomainRestrictionMode |
ドメインの外部への共有モードを指定します。 使用可能な値: none、allowList、blockList。 |
| siteCreationDefaultManagedPath |
文字列 |
チーム サイトの管理パスの値。 これは、新しいチーム サイトが作成されるパスです。 |
| siteCreationDefaultStorageLimitInMB |
Int32 |
作成時の新しいサイトの既定のストレージ クォータ。 メガバイト (MB) 単位で測定されます。 |
| tenantDefaultTimezone |
文字列 |
新しく作成されたサイトのテナントの既定のタイムゾーン。 使用可能な値の一覧については、「 SPRegionalSettings.TimeZones プロパティ」を参照してください。 |
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された 設定 オブジェクトを返します。
例
要求
次の例は要求を示しています。
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
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new SharepointSettings
{
DeletedUserPersonalSiteRetentionPeriodInDays = 365,
ExcludedFileExtensionsForSyncApp = new List<string>
{
".mp3",
},
ImageTaggingOption = ImageTaggingChoice.Enhanced,
IsLegacyAuthProtocolsEnabled = true,
IsSitesStorageLimitAutomatic = false,
IsSyncButtonHiddenOnPersonalSite = false,
IsUnmanagedSyncAppForTenantRestricted = false,
PersonalSiteDefaultStorageLimitInMB = 120000L,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.Sharepoint.Settings.PatchAsync(requestBody);
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewSharepointSettings()
deletedUserPersonalSiteRetentionPeriodInDays := int32(365)
requestBody.SetDeletedUserPersonalSiteRetentionPeriodInDays(&deletedUserPersonalSiteRetentionPeriodInDays)
excludedFileExtensionsForSyncApp := []string {
".mp3",
}
requestBody.SetExcludedFileExtensionsForSyncApp(excludedFileExtensionsForSyncApp)
imageTaggingOption := graphmodels.ENHANCED_IMAGETAGGINGCHOICE
requestBody.SetImageTaggingOption(&imageTaggingOption)
isLegacyAuthProtocolsEnabled := true
requestBody.SetIsLegacyAuthProtocolsEnabled(&isLegacyAuthProtocolsEnabled)
isSitesStorageLimitAutomatic := false
requestBody.SetIsSitesStorageLimitAutomatic(&isSitesStorageLimitAutomatic)
isSyncButtonHiddenOnPersonalSite := false
requestBody.SetIsSyncButtonHiddenOnPersonalSite(&isSyncButtonHiddenOnPersonalSite)
isUnmanagedSyncAppForTenantRestricted := false
requestBody.SetIsUnmanagedSyncAppForTenantRestricted(&isUnmanagedSyncAppForTenantRestricted)
personalSiteDefaultStorageLimitInMB := int64(120000)
requestBody.SetPersonalSiteDefaultStorageLimitInMB(&personalSiteDefaultStorageLimitInMB)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
settings, err := graphClient.Admin().Sharepoint().Settings().Patch(context.Background(), requestBody, nil)
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
SharepointSettings sharepointSettings = new SharepointSettings();
sharepointSettings.setDeletedUserPersonalSiteRetentionPeriodInDays(365);
LinkedList<String> excludedFileExtensionsForSyncApp = new LinkedList<String>();
excludedFileExtensionsForSyncApp.add(".mp3");
sharepointSettings.setExcludedFileExtensionsForSyncApp(excludedFileExtensionsForSyncApp);
sharepointSettings.setImageTaggingOption(ImageTaggingChoice.Enhanced);
sharepointSettings.setIsLegacyAuthProtocolsEnabled(true);
sharepointSettings.setIsSitesStorageLimitAutomatic(false);
sharepointSettings.setIsSyncButtonHiddenOnPersonalSite(false);
sharepointSettings.setIsUnmanagedSyncAppForTenantRestricted(false);
sharepointSettings.setPersonalSiteDefaultStorageLimitInMB(120000L);
SharepointSettings result = graphClient.admin().sharepoint().settings().patch(sharepointSettings);
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
const options = {
authProvider,
};
const client = Client.init(options);
const sharepointSettings = {
deletedUserPersonalSiteRetentionPeriodInDays: 365,
excludedFileExtensionsForSyncApp: ['.mp3'],
imageTaggingOption: 'enhanced',
isLegacyAuthProtocolsEnabled: true,
isSitesStorageLimitAutomatic: false,
isSyncButtonHiddenOnPersonalSite: false,
isUnmanagedSyncAppForTenantRestricted: false,
personalSiteDefaultStorageLimitInMB: 120000
};
await client.api('/admin/sharepoint/settings')
.update(sharepointSettings);
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\SharepointSettings;
use Microsoft\Graph\Generated\Models\ImageTaggingChoice;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new SharepointSettings();
$requestBody->setDeletedUserPersonalSiteRetentionPeriodInDays(365);
$requestBody->setExcludedFileExtensionsForSyncApp(['.mp3', ]);
$requestBody->setImageTaggingOption(new ImageTaggingChoice('enhanced'));
$requestBody->setIsLegacyAuthProtocolsEnabled(true);
$requestBody->setIsSitesStorageLimitAutomatic(false);
$requestBody->setIsSyncButtonHiddenOnPersonalSite(false);
$requestBody->setIsUnmanagedSyncAppForTenantRestricted(false);
$requestBody->setPersonalSiteDefaultStorageLimitInMB(120000);
$result = $graphServiceClient->admin()->sharepoint()->settings()->patch($requestBody)->wait();
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
Import-Module Microsoft.Graph.Sites
$params = @{
deletedUserPersonalSiteRetentionPeriodInDays = 365
excludedFileExtensionsForSyncApp = @(
".mp3"
)
imageTaggingOption = "enhanced"
isLegacyAuthProtocolsEnabled = $true
isSitesStorageLimitAutomatic = $false
isSyncButtonHiddenOnPersonalSite = $false
isUnmanagedSyncAppForTenantRestricted = $false
personalSiteDefaultStorageLimitInMB = 120000
}
Update-MgAdminSharepointSetting -BodyParameter $params
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.sharepoint_settings import SharepointSettings
from msgraph.generated.models.image_tagging_choice import ImageTaggingChoice
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = SharepointSettings(
deleted_user_personal_site_retention_period_in_days = 365,
excluded_file_extensions_for_sync_app = [
".mp3",
],
image_tagging_option = ImageTaggingChoice.Enhanced,
is_legacy_auth_protocols_enabled = True,
is_sites_storage_limit_automatic = False,
is_sync_button_hidden_on_personal_site = False,
is_unmanaged_sync_app_for_tenant_restricted = False,
personal_site_default_storage_limit_in_m_b = 120000,
)
result = await graph_client.admin.sharepoint.settings.patch(request_body)
プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
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)"
}