名前空間: 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"}]
}