directorySetting リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

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

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

ヒント

このリソースの /v1.0 バージョンは groupSetting という名前です。

メソッド

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

プロパティ

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

リレーションシップ

なし

JSON 表記

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

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