groupSetting リソースの種類

名前空間: microsoft.graph

グループ設定は、テナント全体およびオブジェクト固有の制限と許可される動作をカスタマイズするために使用できる構成を定義します。 たとえば、グループ表示名の単語一覧をブロックしたり、ゲストをグループ所有者にするかどうかを定義したりできます。

既定では、すべてのグループがプリセットの既定値を継承します。 既定の設定を変更するには、 groupSettingTemplates を使用して新しい設定オブジェクトを作成する必要があります。 テナント全体と特定のグループの両方で同じ設定が定義されている場合、グループ レベルの設定はテナント全体の設定をオーバーライドします。 たとえば、テナント全体の設定では、グループの既存のメンバーがゲストを招待できる場合があります。ただし、個々のグループ設定をオーバーライドして操作を許可することはできません。

グループ固有の設定は、Microsoft 365 グループにのみ適用されます。

ヒント

このリソースの /beta バージョンは directorySetting という名前です。

メソッド

メソッド	戻り値の型	説明
List	groupSetting コレクション	すべての設定オブジェクトのプロパティを一覧表示します。
Create	groupSetting	groupSettingTemplate に基づいて設定オブジェクトを作成します。
Get	groupSetting	特定の設定オブジェクトのプロパティを参照します。
Update	groupSetting	設定オブジェクトを更新します。
Delete	なし	設定オブジェクトを削除します。

プロパティ

プロパティ	型	説明
displayName	String	関連付けられているテンプレートから取得される設定のこのグループの表示名。
id	String	これらの設定の一意の識別子。 読み取り専用です。
templateId	String	このグループ レベルの設定オブジェクト用にカスタマイズされたテナント レベルの groupSettingTemplates オブジェクトの一意識別子。 読み取り専用です。
values	settingValue コレクション	参照される groupSettingTemplates オブジェクトの name プロパティと defaultValue プロパティに対応する名前と値のペアのコレクション。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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