The term 'New-MailContact' is not recognized

Hi SX,

You're correct in that under default conditions, New-MailContact should be available for members of the Recipient Management role, however, it would pay to check that holds true for your environment.

Here's a couple of commands you can use to validate which roles permit access to New-MailContact as well as  cross-check the RBAC memberships your test account currently holds.

Note the inline comment pertaining to leveraging the -CmdletParameters parameter, as Exchange Online filters beyond the base commandlet and into the actual parameter usage.

# Microsoft Learn reference:
# https://learn.microsoft.com/en-us/powershell/exchange/find-exchange-cmdlet-permissions?view=exchange-ps#use-powershell-to-find-the-permissions-required-to-run-a-cmdlet

# Use this command to verify which roles can run a given command. It may pay to also add in the -CmdletParameters to get a more granular response from Exchange Online.
Get-ManagementRole -Cmdlet "New-MailContact" | ForEach-Object {
    Get-ManagementRoleAssignment -Role $_.Name -Delegating $false | Select-Object -Property Role, RoleAssigneeType, RoleAssigneeName;
} | Format-Table -AutoSize;

# Use this command to enumerate the members of all roles, which you can use to cross-check the test account's current role-based access.
Get-RoleGroup | ForEach-Object {
    $Role = $_;
    Get-RoleGroupMember -Identity $_.Identity | ForEach-Object {
        [PSCustomObject] @{
            Role = $Role.Name;
            Type = $_.RecipientType;
            Member = $_.Identity;
        }
    }
}

Cheers,

Lain

New-MgContact and New-MgUserContact are cmdlets in Microsoft Graph PowerShell, but they serve different purposes:

1. New-MgContact:
   • This cmdlet is used to create a new organizational contact in Microsoft 365. Organizational contacts are typically used for external contacts that are not part of the organization but need to be available in the directory for communication purposes1.
   • Example usage:New-MgContact -DisplayName "John Doe" -Mail "email address removed for privacy reasons"
2. New-MgUserContact:
   • This cmdlet is used to create a new personal contact for a specific user in Microsoft 365. Personal contacts are managed by individual users and are not shared across the organization2.
   • Example usage:New-MgUserContact -UserId $userId -DisplayName "Jane Smith" -EmailAddresses @{Address="email address removed for privacy reasons"; Name="Jane Smith"}

In summary, New-MgContact is for organizational contacts, while New-MgUserContact is for personal contacts managed by individual users.

The New-Mailcontact cmdlet should be available after running Connect-ExchangeOnlineManagement. 

What version of the module are you using? I'm using 3.7.0