GroupMemberControl は、get API と update API の両方の入力データ・オブジェクトで使用されます。
get API では、GroupMemberControl は、グループのメンバーを要求するために使用されます。 入力データ・オブジェクトに GroupMemberControl を追加すると、グループのメンバーが戻されます。 GroupMemberControl はまた、メンバーについて戻すプロパティーのほか、戻すネストされたメンバーのレベルを指定するためにも使用できます。
GroupMemberControl は SearchControl から拡張されるため、プロパティーを指定して、検索条件を満たすグループのみを戻すようにすることができます。 例えば、値「entities[@xsi:type='PersonAccount']」を含むプロパティー expression を追加すれば、PersonAccount エンティティー・タイプのメンバーのみを戻すことができます。
GroupMemberControl level | 説明 |
---|---|
1 (デフォルト) | 直接のメンバーのみを戻します。 |
0 | ネストされたメンバーをすべて戻します。 |
GroupMemberControl modifyMode | 説明 |
---|---|
1 (デフォルト) | 割り当てモード。 グループ・データ・オブジェクトに含まれているメンバーが、グループにメンバーとして追加されます。 |
2 | 置換モード。 グループ・データ・オブジェクトに含まれているメンバーが、グループのメンバーとしてグループに追加され、グループの既存のメンバーがすべて除去されます。 |
3 | 割り当て解除モード。 グループ・データ・オブジェクトに含まれているメンバーが、グループから除去されます。 |
<xsd:complexType name="GroupMemberControl">
<xsd:complexContent>
<xsd:extension base="GroupControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:GroupMemberControl" level="1">
<wim:properties>cn</wim:properties>
<wim:properties>uid</wim:properties>
<wim:properties>o</wim:properties>
<wim:properties>ou</wim:properties>
</wim:controls>
<wim:controls xsi:type="wim:GroupMemberControl" modifyMode="3"/>