GroupMemberControl est utilisé dans l'objet de données d'entrée de l'interface de programme d'application d'extraction et de mise à jour.
Dans l'API d'extraction (get), GroupMemberControl permet de lancer une requête sur les membres d'un groupe. Si vous ajoutez GroupMemberControl à l'objet de données d'entrée, les membres du groupe sont retournés. GroupMemberControl permet également d'indiquer les propriétés des membres à retourner ainsi que le niveau des membres imbriqués à retourner.
GroupMemberControl étant une extension de SearchControl, vous pouvez indiquer les propriétés afin d'obtenir uniquement les groupes qui répondent aux critères de recherche. Par exemple, vous pouvez ajouter une expression de propriété avec la valeur : "entités[@xsi:type='PersonAccount']" pour retourner uniquement les membres dont le type d'entité est PersonAccount.
Niveau GroupMemberControl | Description |
---|---|
1 (par défaut) | Retourne les membres immédiats uniquement. |
0 | Retourne tous les membres imbriqués. |
GroupMemberControl modifyMode | Description |
---|---|
1 (par défaut) | Mode affectation. Les membres contenus dans l'objet de données de groupe sont ajoutés à ce groupe en tant que membres. |
2 | Mode remplacement. Les membres contenus dans l'objet de données de groupe sont ajoutés au groupe en tant que membres et tous les membres existants du groupe sont supprimés. |
3 | Mode non affectation. Les membres contenus dans l'objet de données de groupe sont supprimés du groupe. |
<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"/>