---

Class Relations

• class: ::nx::EnsembleObject

::nx::EnsembleObject create ::ms::Graph::slot::__group::member

Methods (to be applied on the object)

• add (scripted)

  #
  # Add a conversationMember to a group.
  #
  # Details: https://docs.microsoft.com/en-us/graph/api/group-post-members
  #
  
  if {[llength $principals] > 20} {
      error "max 20 users can be added in one call"
  }
  set members@odata.bind [lmap id $principals {
      set _ "https://graph.microsoft.com/v1.0/directoryObjects/${id}"
  }]
  set r [:request -method PATCH -token [:token]  -vars {members@odata.bind:array}  -url /groups/${group_id}]
  return [:expect_status_code $r 204]

• list (scripted)

  #
  # Get a list of the group's direct members. A group can
  # have users, organizational contacts, devices, service
  # principals and other groups as members. Currently
  # service principals are not listed as group members due
  # to staged roll-out of service principals on Graph V1.0
  # endpoint.
  #
  # Details: https://docs.microsoft.com/en-us/graph/api/group-list-members
  #
  # @param count boolean, retrieves the total count of matching resources
  # @param filter retrieve a filtered subset of the tuples
  # @param search returns results based on search criteria.
  # @param top sets the page size of results
  # @param max_entries retrieve this desired number of tuples (potentially multiple API calls)
  
  set r [:request -method GET -token [:token]  -url /groups/${group_id}/members?[:params {count filter search top}]]
  return [:paginated_result_list -max_entries $max_entries $r 200]

• remove (scripted)

  #
  # Remove group member
  #
  # Details: https://docs.microsoft.com/en-us/graph/api/group-delete-members
  #
  set r [:request -method DELETE -token [:token]  -url /groups/${group_id}/members/${principal}/\$ref]
  return [:expect_status_code $r 204]

---