GroupMembershipControl 用于 get API 和 update API 的输入数据对象中。
在 get API 中,GroupMembershipControl 用于请求某个实体所属于的组。如果 theGroupMembershipControl 已添加到输入数据对象,那么将返回实体所属于的组。GroupMembershipControl 还可用于指定要为组返回的属性以及要返回的嵌套组的级别。
由于 GroupMembershipControl 扩展自 SearchControl,因此您可以指定属性仅返回满足搜索标准的组。 例如,您可以添加一个值为“entities[@xsi:type='Group' and cn='Admin*']”的属性表达式,以仅返回其“cn”属性以“Admin”开始的组。
GroupMembershipControl level | 描述 |
---|---|
1(缺省值) | 仅返回直接组。 |
0 | 返回所有嵌套组 |
GroupMembershipControl modifyMode | 描述 |
---|---|
1(缺省值) | 分配方式。实体数据对象中包含的组作为成员来添加实体。 |
2 | 替换方式。实体数据对象中包含的组作为成员来添加实体,并且将移除所有现有成员。 |
3 | 取消分配方式。实体数据对象中包含的组从其成员中移除实体。 |
data object <xsd:complexType name="GroupMembershipControl">
<xsd:complexContent>
<xsd:extension base="GroupControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:GroupMembershipControl" level="1">
<wim:properties>cn</wim:properties>
<wim:properties>displayName</wim:properties>
</wim:controls>
<wim:controls xsi:type="wim:GroupMembershipControl" modifyMode="3"/>