New-CsCallingLineIdentity

Reference

Module:: SkypeForBusiness

Applies to:: Microsoft Teams, Skype for Business Online

Use the New-CsCallingLineIdentity cmdlet to create a new Caller ID policy for your organization.

Syntax

New-CsCallingLineIdentity
   [-Identity] <string>
   [-BlockIncomingPstnCallerID <bool>]
   [-CallingIDSubstitute <string>]
   [-CompanyName <string>]
   [-Description <string>]
   [-EnableUserOverride <bool>]
   [-ResourceAccount <string>]
   [-ServiceNumber <string>][-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

You can either change or block the Caller ID (also called a Calling Line ID) for a user. By default, the Teams or Skype for Business Online user's phone number can be seen when that user makes a call to a PSTN phone, or when a call comes in. You can create a Caller ID policy to provide an alternate displayed number, or to block any number from being displayed.

Note:

Identity must be unique.
ServiceNumber must be a valid Service Number in the tenant telephone number inventory.
If CallerIdSubstitute is given as "Service", then ServiceNumber cannot be empty.
If CallerIdSubstitute is given as "Resource", then ResourceAccount cannot be empty.

Examples

-------------------------- Example 1 --------------------------

New-CsCallingLineIdentity -Identity Anonymous -Description "anonymous policy" -CallingIDSubstitute Anonymous -EnableUserOverride $false

This example creates a new Caller ID policy that sets the Caller ID to Anonymous.

-------------------------- Example 2 --------------------------

New-CsCallingLineIdentity -Identity "UKOrgAA" -CallingIdSubstitute "Service" -ServiceNumber "14258828080" -EnableUserOverride $false -Verbose

This example creates a new Caller ID policy that sets the Caller ID to a specified service number.

-------------------------- Example 3 --------------------------

New-CsCallingLineIdentity -Identity Anonymous -Description "anonymous policy" -CallingIDSubstitute Anonymous -EnableUserOverride $false -BlockIncomingPstnCallerID $true

This example creates a new Caller ID policy that blocks the incoming Caller ID.

Example 4

$ObjId = (Get-CsOnlineApplicationInstance -Identity dkcq@contoso.com).ObjectId
New-CsCallingLineIdentity -Identity DKCQ -CallingIDSubstitute Resource -EnableUserOverride $false -ResourceAccount $ObjId -CompanyName "Contoso"

This example creates 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

Parameters

-BlockIncomingPstnCallerID

The BlockIncomingPstnCallerID switch determines whether to block the incoming Caller ID. The default value is false.

The BlockIncomingPstnCallerID switch is specific to incoming calls from a PSTN caller to a user. If this is set to True and if this policy is assigned to a Lync user, then Caller ID for incoming calls is suppressed/anonymous.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-CallingIDSubstitute

The CallingIDSubstitute parameter lets you specify an alternate Caller ID. The default value is LineUri. Supported values are Anonymous, Service, LineUri, and Resource.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-CompanyName

This parameter sets the Calling party name (typically referred to as CNAM) on the outgoing PSTN call.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-Confirm

The Confirm switch causes the command to pause processing and requires confirmation to proceed.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-Description

The Description parameter briefly describes the Caller ID policy.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-EnableUserOverride

The EnableUserOverride switch lets the user override the Caller ID policy.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-Identity

The Identity parameter identifies the Caller ID policy.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-ResourceAccount

This parameter specifies the ObjectId of a resource account/online application instance used for Teams Auto Attendant or Call Queue. The outgoing PSTN call will use the phone number defined on the resource account as caller id. For more information about resource accounts please see https://docs.microsoft.com/microsoftteams/manage-resource-accounts

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-ServiceNumber

The ServiceNumber parameter lets you add any valid service number for the CallingIdSubstitute.

Note: Do not add '+' to the Service number. For example, if the Service number is +1425-xxx-xxxx then valid input is 1425xxxxxxx

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

-WhatIf

The WhatIf switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Microsoft Teams, Skype for Business Online

Inputs

None

Outputs