groupSetting リソースの種類groupSetting resource type

グループ設定は、グループの表示名のブロックされた単語リスト、ゲストユーザーがグループの所有者になることができるかどうかなどの動作を制御します。Group settings control behaviors such as blocked word lists for group display names or whether guest users are allowed to be group owners.

グループ設定は、使用可能なGroupsettingtemplatesに基づいて作成し、既定の既定値から変更することができます。Group settings can be created based on the available groupSettingTemplates, and changed from their preset defaults. これらの設定は、テナント全体レベルまたは特定のグループに対するグループの動作を管理します。These settings govern group behaviors at a tenant-wide level or to a specific group. テナント全体と特定のグループの両方で同じ設定が定義されている場合、グループレベル設定はテナント全体の設定より優先されます。When the same setting is defined at both the tenant-wide and to a specific group, the group-level setting overrides the tenant-wide setting. たとえば、テナント全体の設定では、グループの既存のメンバーによるゲストの招待が許可されることがありますが、個々のグループの設定を上書きして、グループのメンバーに招待されたゲストの招待を許可することはできません。For example, the tenant-wide setting may allow guests to be invited by existing members of groups, but an individual group setting can override and not allow guests to be invited by members of the group. グループ設定は、Office 365 グループの動作のみを制御します。Group settings only govern Office 365 groups behavior.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
設定を作成するCreate setting groupSettinggroupSetting GroupSettingTemplate に基づいて設定オブジェクトを作成します。Create a setting object based on a groupSettingTemplate. POST 要求は、テンプレートで定義されているすべての設定の settingValues を提供する必要があります。The POST request must provide settingValues for all the settings defined in the template.
設定を取得するGet setting groupSettinggroupSetting 特定の設定オブジェクトのプロパティを参照します。Read properties of a specific setting object.
設定を一覧表示するList settings groupSetting コレクションgroupSetting collection すべての設定オブジェクトのプロパティを一覧表示します。List properties of all setting objects.
設定を更新するUpdate setting groupSettinggroupSetting Groupsetting オブジェクトを更新します。Update groupsetting object.
設定を削除する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.
idid 文字列String これらの設定の一意の識別子。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"}]
}