New-CsCallingLineIdentity

 

Topic Last Modified: 2017-04-06

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

New-CsCallingLineIdentity -Identity <XdsIdentity> [-BlockIncomingPstnCallerID <$true | $false>] [-BypassDualWrite <$true | $false>] [-CallingIDSubstitute <Anonymous | Service | LineUri>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableUserOverride <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-ServiceNumber <String>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

The following example creates a new Caller ID policy that blocks the incoming Caller ID

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

You can either change or block the Caller ID (also called a Calling Line ID) for a user. By default, the 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.

NoteNote:
  • Identity must be unique.

  • ServiceNumber must be a valid Service Number in the Skype for Business Online online telephone number inventory.

  • If CallerIdSubstitute is given as “Service”, then ServiceNumber cannot be empty.

 

Parameter Required Type Description

Identity

Required

Microsoft.Rtc.Management.Xds.XdsIdentity

The Identity parameter identifies the Caller ID policy.

BlockIncomingPstnCallerID

Optional

System.Boolean

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.

CallingIDSubstitute

Optional

Microsoft.Rtc.Management.Internal.CallingIDSubstituteType

The CallingIDSubstitute parameter lets you specify an alternate Caller ID. The default value is LineUri.

Confirm

Optional

System.Management.Automation.SwitchParameter

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

Description

Optional

System.String

The Description parameter briefly describes the Caller ID policy.

EnableUserOverride

Optional

System.Boolean

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

Force

Optional

System.Management.Automation.SwitchParameter

The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for administrative input if required.

InMemory

Optional

System.Management.Automation.SwitchParameter

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set-<cmdlet>.

ServiceNumber

Optional

System.String

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

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

WhatIf

Optional

System.Management.Automation.SwitchParameter

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.

 
Show: