directorySetting リソースの種類

名前空間: microsoft.graph

重要

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

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

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

ヒント

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

メソッド

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

プロパティ

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

リレーションシップ

なし

JSON 表記

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

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