groupSetting リソースの種類

名前空間: microsoft.graph

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

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

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

ヒント

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

メソッド

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

プロパティ

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

リレーションシップ

なし。

JSON 表記

以下は、リソースの JSON 表記です。

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