directorySetting リソースの種類directorySetting resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

ディレクトリの設定は、使用可能なDirectorysettingtemplatesに基づいて作成し、既定の既定値から変更することができます。Directory settings can be created based on the available directorySettingTemplates, and changed from their preset defaults. これらの設定は、テナント全体レベルまたは特定のエンティティレベルで、エンティティまたは機能の動作を制御できます。These settings can govern entity or feature behaviors, both at a tenant-wide level or at a specific entity level. テナント全体と特定のエンティティレベルの両方で同じ設定が定義されている場合、特定のエンティティレベルの設定はテナント全体の設定から除外されることがあります。When the same setting is defined at both the tenant-wide and specific entity level, the specific entity level setting may opt-out from the tenant-wide setting. たとえば、テナント全体の設定では、ゲストがグループの既存のメンバーに招待されることが許可されますが、特定のグループの設定はオプトアウトされ、グループのメンバーによるゲストの招待が許可されない場合があります。For example, the tenant-wide setting may allow guests to be invited by existing members of groups, but a specific group setting may opt-out and not allow guests to be invited by members of the group. 現在、システムで定義されている設定は、Office グループの動作のみを制御します。Currently system defined settings are only govern Office groups behavior.

: directorysetting リソースの種類の/ベータ版は、グループにのみ適用されます。Note: The /beta version of the directorySetting resource type only applies to groups. /V1.0 のバージョンが groupSetting に変更されました。The /v1.0 version has been renamed to groupSetting.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
設定を作成するCreate setting directorySettingdirectorySetting DirectorySettingTemplate に基づいて設定オブジェクトを作成します。Create a setting object based on a directorySettingTemplate. POST 要求は、テンプレートで定義されているすべての設定の settingValues を提供する必要があります。The POST request must provide settingValues for all the settings defined in the template.
設定を取得するGet setting directorySettingdirectorySetting 特定の設定オブジェクトのプロパティを参照します。Read properties of a specific setting object.
設定を一覧表示するList settings directorySetting コレクションdirectorySetting collection すべての設定オブジェクトのプロパティを一覧表示します。List properties of all setting objects.
設定を更新するUpdate setting directorySettingdirectorySetting 設定オブジェクトを更新します。Update a setting object. Update で変更できるのは、設定値だけです。Only settingValues can be changed in an update.
設定を削除するDelete setting なしNone 設定オブジェクトを削除します。Delete a setting object.

プロパティProperties

プロパティProperty Type 説明Description
displayNamedisplayName stringstring 関連付けられたテンプレートに由来する、この設定グループの表示名。Display name of this group of settings, which comes from the associated template. 読み取り専用です。Read-only.
idid stringstring これらの設定の一意の識別子。Unique identifier for these settings. 読み取り専用です。Read-only.
templateIdtemplateId stringstring この設定のグループを作成するために使用されるテンプレートの一意識別子。Unique identifier for the template used to create this group of settings. 読み取り専用です。Read-only.
valuesvalues SettingvalueコレクションsettingValue collection 名前と値のペアのコレクション。Collection of name value pairs. テンプレートで定義されているすべての設定が含まれていて、設定されている必要があります。Must contain and set all the settings defined in the template.

リレーションシップRelationships

なしNone

JSON 表記JSON representation

以下は、リソースの JSON 表記です。Here is a JSON representation of the resource.

{
  "displayName": "string",
  "id": "string (identifier)",
  "templateId": "string",
  "values": [{"@odata.type": "microsoft.graph.settingValue"}]
}