Modifier

New-CsUserCallingDelegate

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

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

Syntax

New-CsUserCallingDelegate
   -Identity <String>
   -Delegate <String>
   -MakeCalls <Boolean>
   -ReceiveCalls <Boolean>
   -ManageSettings <Boolean>
   [<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.

Type:System.String
Position:named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Identity

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

Type:System.String
Position:named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MakeCalls

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

Type:System.Boolean
Position:named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ManageSettings

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

Type:System.Boolean
Position:named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReceiveCalls

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

Type:System.Boolean
Position:named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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.