Assignments

Assignments connect apps to device groups. Creating one queues deployment jobs for every device in the group that runs the app's platform.

WindowsmacOSOwners, Admins and MSP Technicians manage them; Read Only and MSP Read Only can view

In short

  • Windows apps go to the Windows devices in a group, and macOS apps to the Mac devices. Devices on the other platform are skipped.
  • The intent decides what happens: Install, Uninstall, Update Only, or Available in the Self-Service Portal.
  • An assignment can leave out groups. A device in an excluded group is skipped even when it is also in the assigned group.
  • Deleting an assignment cancels the jobs it queued that haven't started, unless another assignment still needs them.

Create an assignment

From an app

  1. Go to Software > Apps in the sidebar and open the app.

  2. Click Assign to Group.

  3. Select a group.

    Choose the target device group. The list shows the number of devices in each group.
  4. Select an intent.

    The intents are described below.
  5. Optionally, tick groups to leave out under Exclude groups.

    See Exclude groups, further down this page.
  6. Click Create Assignment.

Intents

Install (Required)
Install the app on all devices in the group.
Uninstall
Uninstall the app from all devices in the group.
Update Only
Update the app only on devices where it is already installed. Devices without the app are left alone.
Available (Self-Service)Windows apps only
Make the app available for end users to install on demand via the Self-Service Portal. No jobs are created until a user requests the install.

From a group

  1. Go to Groups in the sidebar and open the group.

  2. Click Assign App.

  3. Choose the app and an intent: Install, Uninstall or Update Only.

  4. Click Assign App.

For Install, Uninstall and Update Only, Pckgr immediately creates deployment jobs for the matching devices in the group. For Available, no jobs are created: the app simply appears in the Self-Service Portal for users on Windows devices in that group.

View assignments

On an app’s page
Its assignments are listed under Assignments, with the group, intent and any excluded groups.
On a group’s page
The apps assigned to it are listed under Assigned Apps.

Change an assignment's intent

  1. On an app's detail page, click an assignment to open Edit Assignment.

  2. Change its intent (for example, from Install to Uninstall) or the groups it leaves out.

  3. Click Save.

    Changing the intent creates new deployment jobs for the updated intent.

Delete an assignment

Click the trash icon on an assignment, on the app's page or the group's page, and confirm.

Queued jobs are cancelled

Deleting an assignment cancels the jobs it queued that haven't started yet (pending or deferred), unless another assignment of the same app still reaches that device. A job that is already running finishes. Deleting never uninstalls anything.

Exclude groups

An assignment can leave out one or more groups. A device in an excluded group is skipped even when it is also in the assigned group, so a baseline assigned to All Devices can skip a handful of devices without a second group being created just to hold them.

  • When creating an assignment from an app, tick the groups to leave out under Exclude groups.
  • To change the exclusions later, click the assignment on the app's detail page and adjust the list. Devices that stop being excluded get their deployment jobs straight away; devices that become excluded have their queued jobs cancelled.
  • A device removed from an excluded group, or in an excluded group that is deleted, also gets its deployment jobs straight away. A device that drops out of an excluded dynamic group does not, so one check-in outside the group's rules cannot uninstall anything; a Required install still reaches it at a later check-in.
  • Exclusions apply per assignment. Excluding a group from an Install assignment does not stop the same group from seeing the app as Available through another assignment.
  • The All Devices group cannot be excluded, and a group cannot be excluded from its own assignment.

How assignments work

  • When you create an assignment, a job is created for each device currently in the group that runs the app's platform, minus any device in an excluded group. Devices on the other platform are skipped.
  • If you later add a new device to the group, Pckgr automatically creates jobs for any existing assignments that reach it.
  • If a device later joins an excluded group, the assignment stops applying to it: pending jobs are cancelled when the agent next asks for work, and the app is no longer counted as assigned to that device.
  • If an app has dependencies, those prerequisite apps are deployed first.
  • Failed jobs can be retried from the Deployments page.