directorySetting リソースの種類

[アーティクル]
04/09/2024

名前空間: microsoft.graph

重要

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

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

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

ヒント

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

メソッド

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

プロパティ

プロパティ	型	説明
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"}]
}