Microsoft Entra ID Groups

Bring the device groups you already keep in Microsoft Entra ID into Pckgr instead of building them again by hand. Each becomes a Pckgr group whose members follow the directory, and you assign apps, policies and scripts to it like any other group.

WindowsOwners and Admins connect the directory in Settings; synced groups are used like any other group

In short

  • Connect your directory once per tenant from Settings. A Global Administrator grants Pckgr read-only access.
  • Nothing is imported when you connect. You pick the groups to sync, and only those are read.
  • Members are matched to enrolled Windows devices by their Entra device ID. macOS devices are not matched yet.
  • Membership is refreshed every couple of hours, or straight away with Sync now.
  • Pckgr never changes anything in Microsoft Entra ID.

How it works

  1. Connect your directory from Settings.

    A Global Administrator grants Pckgr read-only access.
  2. Choose groups.

    Nothing is imported when you connect. You pick the groups to sync, and only those are read.
  3. Pckgr matches members to enrolled devices.

    By their Entra device ID, which the Pckgr agent reports.
  4. Membership stays in step with the directory.

    It is refreshed from the directory every couple of hours. A device that enrols later is matched the moment it checks in.

Pckgr never changes anything in Microsoft Entra ID. The permissions it asks for are read-only.

Connect your directory

  1. Go to Settings and open the Integrations tab.

  2. On the Microsoft Entra ID card, click Connect Microsoft Entra ID.

    You are taken to Microsoft to approve the permissions and sign in once more to confirm the directory, then brought back to Pckgr.
  3. In the Choose groups step, pick the groups you want and click Preview.

  4. Click Import N groups.

    N is the number of groups you picked.

The approval must come from a Global Administrator (or Privileged Role Administrator) of the directory, signed in with an account that belongs to it. A guest account cannot connect a directory. If that is not you, click Copy consent linkinstead and send the link to them.

  • The link works once and expires after a few days.
  • When they approve, your Pckgr tenant is connected and you can choose groups.
  • You never need their credentials.
  • A directory can be connected to one Pckgr account at a time.

Managing several customers?

Each Pckgr tenant connects to its own customer directory. Connect them one at a time, sending each customer their own consent link.

Permissions Pckgr asks for

GroupMember.Read.All
Read group names and their members.
Device.Read.All
Read device objects, so members can be matched to enrolled devices.
Organization.Read.All
Read your directory’s name and domains, so Pckgr can show which directory is connected.

These are application permissions, so the sync keeps working when the person who approved it changes roles or leaves. Only the groups you chose are ever read.

Choose groups

The picker lists the security groups in your directory. Search by name and tick the ones you want. Microsoft 365 groups are not listed because they cannot contain devices.

By default it shows only groups that contain devices, because most directories have far more user groups than device groups. Turn the filter off to see every group.

The Preview step shows, for each group, how many devices it has in Entra and how many of them Pckgr can match right now.

  • A group with no device members is almost always a user group.
  • A group where few devices match usually means those devices do not have the Pckgr agent yet, or are on an older agent; they are matched as soon as they check in.
  • Nested groups are resolved: a device in a group that is itself a member of the chosen group counts as a member.
  • Dynamic Entra groups work the same way as assigned ones.

To add more groups later, click Import from Entra ID on the Groups page, or Add more groups on the Settings card.

Synced groups in Pckgr

  • A synced group shows an Entra badge. Its page shows how many members Entra has against how many enrolled devices matched, when it last synced, and a Sync now button.
  • Members and the group name come from the directory, so you cannot add or remove devices, rename the group, or give it rules. Everything else works as usual: assignments, policies, script targets and exclusions.
  • The not matched list on the group page names the Entra members Pckgr has no device for. It doubles as a checklist of devices that still need the agent.
  • Deleting a synced group in Pckgr stops syncing it and removes its assignments. Nothing changes in Microsoft Entra ID.

If the group is deleted in Entra

Pckgr flags it and keeps its devices as they were rather than emptying it, so you can decide what to do.

How devices are matched

The Pckgr agent reports the device's Entra device ID and join type (Entra joined, hybrid joined, Entra registered, or not joined) with its hardware inventory. A member of a synced group is matched when an enrolled Windows device has reported that ID.

Devices that are not joined to Microsoft Entra ID, or that are joined to a different directory, are never matched. macOS devices are not matched yet.

The join type also appears on the device page and can be used in dynamic group rules, for example a group of every hybrid-joined device.

When things change

What changesWhat Pckgr does
A device is added to or removed from the group in EntraPicks it up at the next scheduled sync, or straight away with Sync now.
A new device enrols in PckgrMatches it on its first check-in, without waiting for a sync.
The group is renamed in EntraThe Pckgr group follows at the next sync, unless another Pckgr group already uses the new name.
Access is revoked in EntraThe Settings card and the group pages show Needs attention with the reason. Run the consent link again to restore it; groups keep their devices meanwhile.

Sync now can be used a few minutes apart. The scheduled sync runs every couple of hours.

Disconnect

Disconnect on the Settings card stops Pckgr reading your directory. Synced groups keep the devices they have and stop updating; delete them when you no longer need them.

To remove Pckgr's access on the Microsoft side as well, delete the Pckgr Directory Sync enterprise application in the Microsoft Entra admin center.