GroupMemberControl 数据对象

GroupMemberControl 用于 get API 和 update API 的输入数据对象中。

在 get API 中,GroupMemberControl 用于请求组的成员。如果 GroupMemberControl 已添加到输入数据对象,那么将返回组的成员。GroupMemberControl 还可用于指定要为成员返回的属性以及要返回的嵌套成员的级别。

由于 GroupMemberControl 扩展自 SearchControl,因此您可以指定属性仅返回满足搜索标准的组。 例如,您可以添加一个值为“entities[@xsi:type='PersonAccount']”的属性表达式,以仅返回 PersonAccount 实体类型。

get API 中 GroupMembershipControl 数据对象的数据图结构由以下内容组成:
properties
是您希望从与搜索标准匹配的实体中返回的属性的列表。例如,您希望获取位于市场营销部门的个人的 sn 和 givenName 属性。
searchBases
是一个搜索条件的列表,用于将搜索限制为列表中指定这些条件。
countLimit
用于指定由搜索操作返回的搜索结果的最大数量。
timeLimit
如果概要文件存储库支持 timeLimit,那么此属性指定搜索的最长持续时间(以毫秒为单位)。
expression
是 XPath 格式的搜索表达式。
level
用于指示要返回的层次结构的级别。在 GroupMemberControl 中,它指示嵌套成员的级别。请参阅下表。
此表汇总了 level 的可能值:
表 1. GroupMemberControl 的 level 值
GroupMemberControl level 描述
1(缺省值) 仅返回直接成员。
0 返回所有嵌套成员。
update API 中 GroupMembershipControl 数据对象的数据图结构由以下内容组成:
modifyMode
指定要使用分配、修改还是取消分配方式。请参阅下表。
此表汇总了 modifyMode 的可能值:
表 2. GroupMemberControl 的 modifyMode 值
GroupMemberControl modifyMode 描述
1(缺省值) 分配方式。将作为成员将组数据对象中包含的成员添加到此组。
2 替换方式。将作为组的成员将组数据对象中包含的成员添加到此组,并且将移除组的所有现有成员。
3 取消分配方式。将从组中移除组数据对象中包含的成员。

XML 模式定义

以下是 GroupMemberControl 数据对象的 XML 模式定义:
<xsd:complexType name="GroupMemberControl">
    <xsd:complexContent>
	 <xsd:extension base="GroupControl">
	 </xsd:extension>
    </xsd:complexContent>
	</xsd:complexType>

样本数据对象

以下是 get API 中使用的一个样本 GroupMemberControl 数据对象。该数据对象请求组的直接成员 (level=1)。它还指示返回成员的 uid、cn、o 和 ou 属性(如果这些属性存在)。
    <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>
以下是 update API 中使用的一个样本 GroupMemberControl 数据对象。该数据对象指示将从组中取消分配成员。
<wim:controls xsi:type="wim:GroupMemberControl" modifyMode="3"/>


使用条款 | 反馈