GroupMemberControl 用于 get API 和 update API 的输入数据对象中。
在 get API 中,GroupMemberControl 用于请求组的成员。如果 GroupMemberControl 已添加到输入数据对象,那么将返回组的成员。GroupMemberControl 还可用于指定要为成员返回的属性以及要返回的嵌套成员的级别。
由于 GroupMemberControl 扩展自 SearchControl,因此您可以指定属性仅返回满足搜索标准的组。 例如,您可以添加一个值为“entities[@xsi:type='PersonAccount']”的属性表达式,以仅返回 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"/>