Set the Caller ID for a user
Phone System in Microsoft 365 provides a default caller ID that is the user's assigned telephone number. You can either change or block the caller ID (also called a Calling Line ID) for a user. You can learn more about how to use caller ID in your organization by going How can caller ID be used in your organization.
By default, the following caller ID settings are turned off. This means that the Teams user's phone number can be seen when that user makes a call to a PSTN phone. You can change these settings as follows:
Outgoing caller ID You can replace a user's Caller ID, which by default is their telephone number, with another phone number. For example, you could change the user's Caller ID from their phone number to a main phone number for your business or to a main phone number for the legal department. Additionally, you can set the Calling ID number to any online service number (toll or toll-free) or to an on-premises phone number through Direct Routing that is assigned to a resource account used by an Auto Attendant or a Call Queue.
If you want to use the Service parameter, you must specify a valid service number. You need to use the PowerShell cmdlets New-CsCallingLineIdentity or Set-CsCallingLineIdentity in the Teams PowerShell module 2.3.1 or later for the Resource account number if it is not visible in the dropdown.
Block outbound caller ID. You can block the outgoing Caller ID from being sent on a user's outgoing PSTN calls. Doing this will block their phone number from being displayed on the phone of a person being called.
Block incoming caller ID. You can block a user from receiving Caller ID on any incoming PSTN calls.
Set Calling Party Name (CNAM). For your Microsoft Teams users you can send a CNAM on outbound PSTN calls.
Emergency calls will always send the user's telephone number (caller ID).
To learn more about these settings and how you can use them, see How can caller ID be used in your organization.
Set your caller ID policy settings
To set the caller ID to a resource account phone number and to set the calling party name, use the PowerShell cmdlets New-CsCallingLineIdentity or Set-CsCallingLineIdentity in the Teams PowerShell module 2.3.1 or later. (These options are not currently available in the Microsoft Teams admin center.)
Open a Windows PowerShell command prompt and run the following commands:
# When using Teams PowerShell Module Import-Module MicrosoftTeams $credential = Get-Credential Connect-MicrosoftTeams -Credential $credential
View, create, and apply policy settings
To view all of the caller ID policy settings in your organization, run:
For more information, see Get-CsCallingLineIdentity.
To create a new caller ID policy for your organization, use the New-CsCallingIdentity cmdlet:
New-CsCallingLineIdentity -Identity Anonymous -Description "Anonymous policy" -CallingIDSubstitute Anonymous -EnableUserOverride $false
In all cases, the "Service Number" field should not include an initial "+".
For more information, see New-CsCallingLineIdentity.
Apply the new policy you created by using the Grant-CsCallingIdentity cmdlet. For example, the following example applies the new policy to user Amos Marble.
Grant-CsCallingLineIdentity -Identity "firstname.lastname@example.org" -PolicyName Anonymous
For more information, see Grant-CsCallingLineIdentity cmdlet.
If you want to block the incoming caller ID, run:
Set-CsCallingLineIdentity -Identity "Block Incoming" -BlockIncomingPstnCallerID $true
For more information, see Set-CsCallingLineIdentity.
To apply the policy setting you created to a user in your organization, run:
Grant-CsCallingLineIdentity -Identity "email@example.com" -PolicyName "Block Incoming"
For more information, see Grant-CsCallingLineIdentity.
To create a new Caller ID policy that sets the Caller ID to the phone number of the specified resource account and sets the Calling party name to Contoso:
$ObjId = (Get-CsOnlineApplicationInstance -Identity firstname.lastname@example.org).ObjectId New-CsCallingLineIdentity -Identity DKCQ -CallingIDSubstitute Resource -EnableUserOverride $false -ResourceAccount $ObjId -CompanyName "Contoso"
If you have already created a policy, you can use the Set-CsCallingLineIdentity cmdlet to make changes to the existing policy, and then use the Grant-CsCallingLineIdentity cmdlet to apply the settings to your users.
Remove a policy setting
To remove a policy from your organization, run:
Remove-CsCallingLineIdentity -Identity "My Caller ID Policy"
To remove a policy from a user, run:
Grant-CsCallingLineIdentity -Identity "email@example.com" -PolicyName $null
Want to know more about Windows PowerShell?
Windows PowerShell is all about managing users and what users are allowed or not allowed to do. With Windows PowerShell, you can manage Microsoft 365 using a single point of administration that can simplify your daily work. To get started with Windows PowerShell, see these topics:
Windows PowerShell has many advantages in speed, simplicity, and productivity over only using the Microsoft 365 admin center such as when you are making setting changes for many users at one time. Learn about these advantages in the following topics:
Submit and view feedback for