How to list suspended users with GAM

One GAM7 command lists every suspended account in your domain. Here is the command, the form Google uses in its own examples, and why the list matters more than it looks: every account on it is still holding a license.

Every district collects suspended accounts. A teacher who left in 2019, suspended "until we sort out their Drive". A student who transferred out and might have come back. Each one made sense at the time, and nobody can now say how many there are.

The short answer

gam print users issuspended

That prints one row per suspended account, and the row carries more than an address. Alongside suspended you get suspensionTime and suspensionReason, so the list already answers when each account was suspended and why. An account an administrator suspended by hand comes back with a reason of ADMIN.

To send the list straight to a Google Sheet instead:

gam print users issuspended todrive

Google's own GAM example selects the same accounts with a query instead of the option:

gam print users query "isSuspended=True"

(Archive users in Education editions) Either works. The option is shorter; the query is the form you will meet in Google's documentation.

One part of the district at a time

To limit the list to one organizational unit:

gam print users issuspended limittoou "/Staff"

Quote any organizational unit path that contains a space.

What suspended actually means

Suspension stops the person, not the account. From Google's Admin Help: "Google Drive files and Gmail are unavailable to the user" and "New email and calendar invitations are blocked." (Suspend a user temporarily)

Everything they shared stays shared. The same page: "Collaborators who have been granted access to shared documents will retain their ability to view, edit, and collaborate on those documents." A suspended account is still very much present, which is exactly why the list is worth reading rather than just counting.

Suspension keeps the license assigned

Google is unambiguous for paid editions: "Suspended accounts are still charged at the same rate as active accounts on both the Annual billing plan and the Flexible plan." (Suspend a user temporarily)

In Education Fundamentals the cost is a license rather than money, and the way to get it back is to archive the account: "Archiving a user account changes their status to archived and assigns them an Archived User license, freeing up their former license." (Archive users in Education editions) That is the next step for most of the accounts this command finds. See how to archive suspended users with GAM.

Sources

In ORINEX Workspace, the Users page filters to suspended accounts in one click, next to the offboarding workflow that suspends leavers and files them into your suspended OU. What ORINEX Workspace does.