Edit

Share via


New-CsUserCallingDelegate

This cmdlet will add a new delegate for calling in Microsoft Teams.

Syntax

Default (Default)

New-CsUserCallingDelegate
    -Identity <String>
    -Delegate <String>
    -MakeCalls <Boolean>
    -ManageSettings <Boolean>
    -ReceiveCalls <Boolean>
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [<CommonParameters>]

Description

This cmdlet adds a new delegate with given permissions for the specified user.

Examples

Example 1

New-CsUserCallingDelegate -Identity user1@contoso.com -Delegate user2@contoso.com -MakeCalls $true -ReceiveCalls $true -ManageSettings $true

Parameters

-Delegate

The Identity of the delegate to add. Can be specified using the ObjectId or the SIP address.

A user can have up to 25 delegates.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HttpPipelinePrepend

{{ Fill HttpPipelinePrepend Description }}

Parameter properties

Type:

Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Runtime.SendAsyncStep[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

The Identity of the user to add a delegate for. Can be specified using the ObjectId or the SIP address.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MakeCalls

Specifies whether delegate is allowed to make calls on behalf of the specified user.

Parameter properties

Type:System.Boolean
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

All
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ManageSettings

Specifies whether delegate is allowed to change the delegate and calling settings for the specified user.

Parameter properties

Type:System.Boolean
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

All
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ReceiveCalls

Specifies whether delegate is allowed to receive calls on behalf of the specified user.

Parameter properties

Type:System.Boolean
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

All
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

System.Object

Notes

The cmdlet is available in Teams PowerShell module 4.0.0 or later.

The specified user need to have the Microsoft Phone System license assigned.

You can see the delegate of a user by using the Get-CsUserCallingSettings cmdlet.