Skip to main content

entra agent list

Retrieves a list of agents

Usage​

m365 entra agent list [options]

Options​

-p, --properties [properties]

Comma-separated list of properties to be returned.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

Using the --properties option, you can specify a comma-separated list of agent properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will output the default properties returned by Graph.

Permissions​

ResourcePermissions
Microsoft GraphUser.ReadBasic.All

Examples​

Retrieve all agents.

m365 entra agent list

Retrieve id and name of all agents

m365 entra agent list --properties 'id,displayName'

Response​

[
  {
    "id": "819f4e7f-a913-448a-9b5c-2cae064cabe7",
    "deletedDateTime": null,
    "accountEnabled": true,
    "ageGroup": null,
    "businessPhones": [],
    "city": null,
    "companyName": null,
    "consentProvidedForMinor": null,
    "country": null,
    "createdDateTime": "2026-07-14T04:19:25Z",
    "creationType": null,
    "department": null,
    "displayName": "Sales Agent",
    "employeeId": null,
    "employeeHireDate": null,
    "employeeLeaveDateTime": null,
    "employeeType": null,
    "externalUserState": null,
    "externalUserStateChangeDateTime": null,
    "faxNumber": null,
    "givenName": null,
    "isLicenseReconciliationNeeded": false,
    "jobTitle": null,
    "legalAgeGroupClassification": null,
    "mail": null,
    "mailNickname": "SalesAgent",
    "mobilePhone": null,
    "onPremisesDistinguishedName": null,
    "onPremisesDomainName": null,
    "onPremisesImmutableId": null,
    "onPremisesLastSyncDateTime": null,
    "onPremisesSecurityIdentifier": null,
    "onPremisesSamAccountName": null,
    "onPremisesSyncEnabled": null,
    "onPremisesUserPrincipalName": null,
    "otherMails": [],
    "passwordPolicies": null,
    "officeLocation": null,
    "postalCode": null,
    "preferredDataLocation": null,
    "preferredLanguage": null,
    "proxyAddresses": [],
    "refreshTokensValidFromDateTime": null,
    "imAddresses": [],
    "isResourceAccount": null,
    "showInAddressList": null,
    "securityIdentifier": "S-1-12-1-2174701183-1149937939-2922142875-3869985798",
    "signInSessionsValidFromDateTime": null,
    "state": null,
    "streetAddress": null,
    "surname": null,
    "usageLocation": null,
    "userPrincipalName": "SalesAgent@contoso.com",
    "externalUserConvertedOn": null,
    "userType": "Member",
    "identityParentId": "54d8c728-decb-477b-beb6-19570d8a51ab",
    "agentIdentityBlueprintId": "822c92e8-29d7-4f83-903a-744d00628003",
    "employeeOrgData": null,
    "passwordProfile": null,
    "identityParent": {
      "id": "54d8c728-decb-477b-beb6-19570d8a51ab"
    },
    "assignedLicenses": [],
    "assignedPlans": [],
    "authorizationInfo": {
      "certificateUserIds": []
    },
    "identities": [
      {
        "signInType": "userPrincipalName",
        "issuer": "contoso.com",
        "issuerAssignedId": "SalesAgent@contoso.com"
      }
    ],
    "onPremisesProvisioningErrors": [],
    "onPremisesExtensionAttributes": {
      "extensionAttribute1": null,
      "extensionAttribute2": null,
      "extensionAttribute3": null,
      "extensionAttribute4": null,
      "extensionAttribute5": null,
      "extensionAttribute6": null,
      "extensionAttribute7": null,
      "extensionAttribute8": null,
      "extensionAttribute9": null,
      "extensionAttribute10": null,
      "extensionAttribute11": null,
      "extensionAttribute12": null,
      "extensionAttribute13": null,
      "extensionAttribute14": null,
      "extensionAttribute15": null
    },
    "provisionedPlans": [],
    "serviceProvisioningErrors": []
  }
]