New-CsCallingLineIdentity

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

Syntax

New-CsCallingLineIdentity
   [[-Identity] <Object>]
   [-BlockIncomingPstnCallerID <Object>]
   [-BypassDualWrite <Object>]
   [-CallingIDSubstitute <Object>]
   [-Confirm]
   [-Description <Object>]
   [-EnableUserOverride <Object>]
   [-Force]
   [-InMemory]
   [-ServiceNumber <Object>]
   [-Tenant <Object>]
   [-WhatIf]
   [-AsJob]
   [<CommonParameters>]

Description

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.

Note:

  • 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.

Examples

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

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 Anonymous.

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

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

The following 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

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

Optional Parameters

-AsJob

{{Fill AsJob Description}}

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-BlockIncomingPstnCallerID

PARAMVALUE: $true | $false

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:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-BypassDualWrite

PARAMVALUE: $true | $false

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-CallingIDSubstitute

PARAMVALUE: Anonymous | Service | LineUri

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

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Confirm

PARAMVALUE: SwitchParameter

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:Skype for Business Online
-Description

PARAMVALUE: String

The Description parameter briefly describes the Caller ID policy.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-EnableUserOverride

PARAMVALUE: $true | $false

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

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Force

PARAMVALUE: 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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Identity

PARAMVALUE: XdsIdentity

The Identity parameter identifies the Caller ID policy.

Type:Object
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-InMemory

PARAMVALUE: 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-.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-ServiceNumber

PARAMVALUE: String

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:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Tenant

PARAMVALUE: Guid

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-WhatIf

PARAMVALUE: 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.

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

Inputs

None

Outputs

None