What is the UserID required by Get-MgUserContact?

Question

According to the documentation, Get-MgUserContact requires either a UPN or a UserId in the -UserId field. However, mail contacts don't have UPNs, and the documentation doesn't define what a mail contact's UserID is. I've tried email address, display name, alias, Identity (from Get-MailContact), ExchangeObjectId, and Guid (same as ExchangeObjectId). Everything returns "Get-MgUserContact : The requested user '<attempted UserID value>' is invalid."

Get-MgUserContact -UserId ??????

Answer 1

Hello JayCarper-5747,

Thanks for your question.

The user Id is the unique identifier (ObjectId) from Entra ID.

To find a user's object ID, use the following steps:

1. Sign in to the Azure portal.
2. Select Microsoft Entra ID from the menu.
3. Locate the Manage section on the menu and then select Users.
4. On the Users page, enter the user's name in the Search box.
5. Select the user's name where it appears on the list.
6. Locate the Basic info section on the user's Profile page. The Object ID that is displayed is the user's unique object ID.

The above is documented here: https://learn.microsoft.com/en-us/partner-center/account-settings/find-ids-and-domain-names

You can mark it 'Accept Answer' and 'Upvote' if this helped you

Regards,

Abiola

Answer 2

You are correct that contact objects do not have a UPN. However, the cmdlet above does not run against a specific contact object, instead it lists all the personal contacts stored in a given user's mailbox. In effect, the UserId value you are providing is for the owner of said mailbox, which does have an UPN.

In other words, this cmdlet will return your personal contacts:

Get-MgUserContact -UserId jay.carper@domain.com