GroupMembershipControl é utilizado no objeto de dados de entrada da API de obtenção e da API de atualização.
Na API de obtenção, GroupMembershipControl é utilizado para solicitar os grupos aos quais a entidade pertence. Se o GroupMemberControl for incluído no objeto de dados de entrada, os grupos aos quais a entidade pertence serão retornados. GroupMembershipControl também pode ser utilizado para especificar as propriedades a serem retornadas para grupos, bem como o nível dos grupos aninhados a serem retornados.
Porque GroupMembershipControl é estendido a partir de SearchControl, você pode especificar propriedades para retornar apenas os grupos que satisfaçam o critério de procura. Por exemplo, você pode incluir a expressão de propriedade com valor: “entities[@xsi:type='Group' and cn='Admin*']” para retornar apenas os grupos cuja propriedade “cn” inicie com “Admin”.
nível GroupMembershipControl | Descrição |
---|---|
1 (padrão) | Retorna apenas grupos imediatos. |
0 | Retorna todos os grupos aninhados. |
GroupMembershipControl modifyMode | Descrição |
---|---|
1 (padrão) | Modo Designar. Os grupos contidos no objeto de dados da entidade incluem a entidade como um membro. |
2 | Modo Substituir. Os grupos contidos no objeto de dados da entidade incluem a entidade como um membro e todos os membros existentes são removidos. |
3 | Modo Remover Atribuição. Os grupos contidos no objeto de dados da entidade removem a entidade de seus membros. |
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"/>