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 に基づいて作成することができ、事前設定された既定値を変更することができます。これらの設定は、テナント全体のレベルまたは特定のグループのグループ基本動作を制御します。テナント全体および特定のグループの両方で同じ設定が定義されている場合、グループ レベルの設定がテナント全体の設定よりも優先されます。たとえば、テナント全体の設定では、ゲストは既存のグループのメンバーによって招待されることがありますが、個別のグループ設定を優先することができ、その場合は、グループのメンバーはゲストを招待することができません。グループ設定は、Office 365 グループの動作のみを制御します。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. Group settings only govern Office 365 groups behavior.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
設定を作成するCreate setting groupSettinggroupSetting groupSettingTemplate に基づいて、設定オブジェクトを作成します。POST 要求は、テンプレートに定義されているすべての設定の settingValues を提供する必要があります。Create a setting object based on a groupSettingTemplate. 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 文字列String 関連するテンプレートに由来する設定グループの名前を表示します。Display name of this group of settings, which comes from the associated template.
idid 文字列String 設定の一意識別子です。読み取り専用です。Unique identifier for these settings. Read-only.
templateIdtemplateId 文字列String 設定グループの作成に使用されるテンプレートの一意識別子です。読み取り専用です。Unique identifier for the template used to create this group of settings. Read-only.
values 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"}]
}