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