GroupMembershipControl se utiliza en el objeto de datos de entrada tanto de la API de obtención (get) como de la API de actualización (update).
En la API de obtención (get), GroupMembershipControl se utiliza para solicitar los grupos a los que pertenece una entidad. Si theGroupMembershipControl se añade al objeto de datos de entrada, se devuelven los grupos a los que pertenece la entidad. GroupMembershipControl también se puede utilizar para especificar las propiedades que se devolverán para los grupos así como el nivel de los grupos anidados que se devolverá.
Debido a que GroupMembershipControl se extiende desde SearchControl, puede especificar propiedades para devolver únicamente los grupos que cumplan los criterios de búsqueda. Por ejemplo, puede añadir una expresión de propiedad con el valor: “entities[@xsi:type='Group' and cn='Admin*']” para devolver únicamente los grupos cuya propiedad “cn” empiece por “Admin”.
Nivel de GroupMembershipControl | Descripción |
---|---|
1 (valor predeterminado) | Sólo devuelve grupos inmediatos. |
0 | Devuelve todos los grupos anidados |
GroupMembershipControl modifyMode | Descripción |
---|---|
1 (valor predeterminado) | Modalidad de asignación. Los grupos contenidos en el objeto de datos de entidad añaden la entidad como un miembro. |
2 | Modalidad de sustitución. Los grupos contenidos en el objeto de datos de entidad añaden la entidad como un miembro y se eliminan todos los miembros existentes. |
3 | Modalidad de desasignación. Los grupos contenidos en el objeto de datos de entidad eliminan la entidad de sus miembros. |
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"/>