Synchronize Active Directory Groups to Yeastar P-Series Software Edition

This topic describes how to customize the synchronization rule based on Active Directory (AD) groups, so as to synchronize desired AD groups to the PBX extension groups.


The number of AD groups that can be synced depends on the extension groups that PBX system can create (up to 63 extension groups).


You have integrated Yeastar P-Series Software Edition with Active Directory .


  1. Log in to PBX web portal, go to Integrations > Collaboration.
  2. Scroll down to the Group Synchronization section, turn on the switch.

  3. In the Synchronize for field, specify the AD groups that you want to synchronize to PBX.

    Table 1.
    Option Description
    All Groups Synchronize all AD groups within the connected directory to PBX.
    Specific Group Type

    Synchronize the specified type(s) of AD groups to PBX.

    You can select the desired type(s) of AD groups from the Type drop-down list.
    • Security Group: All security groups in the Active Directory.
    • Distribution Group: All distribution groups in the Active Directory.
    Groups Searched by Filter Synchronize the AD groups that match the search filter to PBX.

    You can specify the LDAP search criteria in the Search Filter for Group field to locate specific groups.

    For example, enter (&(objectCategory=group)(cn=sales*)) to search groups with the name starting with "sales".

    Note: In future use, if you change the range of AD groups to be synced, you can decide how to deal with the extension groups that are no longer synced from the AD groups via the Auto delete the Extension Groups no longer in sync option.

    • If selected, the extension groups will be deleted during the next synchronization.
    • If unselected, the extension groups will be retained and fully managed by the PBX.
  4. Click Save.


You have created your custom synchronization rule for AD groups.

During a synchronization process, PBX system performs LDAP queries within the Active Directory based on the rule, and synchronize the desired AD groups as well as the updated information to PBX. After the synchronization, the followings can be implemented:

  • You can check the synchronization result in the Group Synchronization section.

  • The extension groups associated with AD groups come with a label , and can NOT be deleted.
  • You can NOT manually update the name and group member of the extension groups associated with AD groups.
    Note: The information can only be modified within the Active Directory and updated to the PBX during a synchronization.