Merge pull request MicrosoftDocs#8699 from JensTrier/SetCallingAndDelegate

Set calling settings and manage delegates

Author: tiburd

teams/teams-ps/teams/Get-CsUserCallingSettings.md

@@ -41,17 +41,14 @@ IsForwardingEnabled       : True
 ForwardingType            : Immediate
 ForwardingTarget          :
 ForwardingTargetType      : Voicemail
-ForwardingDelay           : 00:00:00
 IsUnansweredEnabled       : False
-IsSafeForward             : False
 UnansweredTarget          :
 UnansweredTargetType      : Voicemail
 UnansweredDelay           : 00:00:20
 Delegates                 :
 Delegators                :
 CallGroupOrder            : InOrder
 CallGroupTargets          : {}
-CallGroupDelay            :
 GroupMembershipDetails    :
 GroupNotificationOverride :
 ```
@@ -68,17 +65,14 @@ IsForwardingEnabled       : True
 ForwardingType            : Simultaneous
 ForwardingTarget          : [email protected]
 ForwardingTargetType      : SingleTarget
-ForwardingDelay           : 00:00:00
 IsUnansweredEnabled       : True
-IsSafeForward             : False
 UnansweredTarget          :
 UnansweredTargetType      : Voicemail
 UnansweredDelay           : 00:00:20
 Delegates                 :
 Delegators                :
 CallGroupOrder            : InOrder
 CallGroupTargets          : {}
-CallGroupDelay            :
 GroupMembershipDetails    :
 GroupNotificationOverride :
 ```
@@ -96,17 +90,14 @@ IsForwardingEnabled       : True
 ForwardingType            : Simultaneous
 ForwardingTarget          :
 ForwardingTargetType      : Group
-ForwardingDelay           : 00:00:00
 IsUnansweredEnabled       : True
-IsSafeForward             : False
 UnansweredTarget          :
 UnansweredTargetType      : Voicemail
 UnansweredDelay           : 00:00:20
 Delegates                 :
 Delegators                :
 CallGroupOrder            : InOrder
 CallGroupTargets          : {[email protected]}
-CallGroupDelay            :
 GroupMembershipDetails    : CallGroupOwnerId:[email protected]
 GroupNotificationOverride : Mute
 ```
@@ -119,8 +110,9 @@ CallGroupOwnerId            NotificationSetting
 [email protected]           Ring
 ```
 
-This example shows that [email protected] has simultaneous ringing set to his/her call group (ForwardingTargetType) and that the call group contains [email protected] (CallGroupTargets).
-The call group is defined to ring members in the order listed in the call group (CallGroupOrder).
+This example shows that [email protected] has simultaneous ringing set to his/her call group (ForwardingTargetType) and that the call group contains [email protected] 
+(CallGroupTargets). The call group is defined to ring members in the order listed in the call group (CallGroupOrder).
+
 You can also see that [email protected] is a member of [email protected]'s call group (GroupMembershipDetails), that [email protected] defined the call group with Ring
 notification for [email protected] (NotificationSetting) and that [email protected] has decided to turn off call notification for call group calls (GroupNotificationOverride).
 
@@ -135,17 +127,14 @@ IsForwardingEnabled       : True
 ForwardingType            : Simultaneous
 ForwardingTarget          :
 ForwardingTargetType      : MyDelegates
-ForwardingDelay           : 00:00:00
 IsUnansweredEnabled       : True
-IsSafeForward             : True
 UnansweredTarget          :
 UnansweredTargetType      : Voicemail
 UnansweredDelay           : 00:00:20
 Delegates                 : Id:[email protected]
 Delegators                : 
 CallGroupOrder            : InOrder
 CallGroupTargets          : {}
-CallGroupDelay            :
 GroupMembershipDetails    :
 GroupNotificationOverride : Ring
 ```
@@ -154,15 +143,13 @@ GroupNotificationOverride : Ring
 ```
 ```output
 Id             : [email protected]
-IsActive       : True
-CreatedDate    : 14-10-2021 09:46:00
 MakeCalls      : True
 ManageSettings : True
 ReceiveCalls   : True
 ```
 
-This example shows that [email protected] has simultaneous ringing set to his/her delegates (ForwardingTargetType). [email protected] is the only delegate (Delegates) and that user
-has all the permissions you can have as a delegate (Delegates).
+This example shows that [email protected] has simultaneous ringing set to his/her delegates (ForwardingTargetType). [email protected] is the only delegate (Delegates) and 
+that user has all the permissions you can have as a delegate (Delegates).
 
 ### Example 5
 ```powershell
@@ -171,20 +158,17 @@ Get-CsUserCallingSettings -Identity [email protected]
 ```output
 SipUri                    : sip:[email protected]
 IsForwardingEnabled       : False
-ForwardingType            : Simultaneous
+ForwardingType            : Immediate
 ForwardingTarget          :
 ForwardingTargetType      : Voicemail
-ForwardingDelay           : 00:00:00
 IsUnansweredEnabled       : True
-IsSafeForward             : True
 UnansweredTarget          :
 UnansweredTargetType      : Voicemail
 UnansweredDelay           : 00:00:20
 Delegates                 :
 Delegators                : Id:[email protected]
 CallGroupOrder            : InOrder
 CallGroupTargets          : {}
-CallGroupDelay            :
 GroupMembershipDetails    :
 GroupNotificationOverride : Ring
 ```
@@ -193,15 +177,13 @@ GroupNotificationOverride : Ring
 ```
 ```output
 Id             : [email protected]
-IsActive       : True
-CreatedDate    : 14-10-2021 09:46:56
 MakeCalls      : True
 ManageSettings : True
 ReceiveCalls   : True
 ```
 
-This example shows that [email protected] is a delegate of [email protected] (Delegators) and that [email protected] has given [email protected] all the permissions you can have as a delegate (Delegators).
-
+This example shows that [email protected] is a delegate of [email protected] (Delegators) and that [email protected] has given [email protected] all the permissions you can
+have as a delegate (Delegators).
 
 
 ## PARAMETERS
@@ -233,9 +215,14 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ### System.Object
 
 ## NOTES
-The cmdlet is available in Teams PowerShell module 2.6.1-preview or later.
-
-You might see raw identities, i.e. ObjectId's, for identities used in the output. It is a known issue that we are working to fix.
+The cmdlet is available in Teams PowerShell module 3.0.1-preview.
 
 ## RELATED LINKS
 
+[Set-CsUserCallingSettings](Set-CsUserCallingSettings.md)
+
+[New-CsUserCallingDelegate](New-CsUserCallingDelegate.md)
+
+[Set-CsUserCallingDelegate](Set-CsUserCallingDelegate.md)
+
+[Remove-CsUserCallingDelegate](Remove-CsUserCallingDelegate.md)

teams/teams-ps/teams/New-CsUserCallingDelegate.md

@@ -0,0 +1,139 @@
+---
+external help file: Microsoft.Open.Teams.CommonLibrary.dll-Help.xml
+Module Name: MicrosoftTeams
+online version: https://docs.microsoft.com/powershell/module/teams/new-csusercallingdelegate
+applicable: Microsoft Teams
+author: jenstrier
+ms.author: jenstr
+ms.reviewer: 
+manager:
+schema: 2.0.0
+---
+
+# New-CsUserCallingDelegate
+
+## SYNOPSIS
+This cmdlet will add a new delegate for calling in Microsoft Teams.
+
+> [!NOTE]
+> **Preview** The use of this cmdlet is in Public Preview.
+  
+## SYNTAX
+
+### Identity (Default)
+```powershell
+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
+```powershell
+New-CsUserCallingDelegate -Identity [email protected] -Delegate [email protected] -MakeCalls $true -ReceiveCalls $true -ManageSettings $true
+```
+
+## PARAMETERS
+
+### -Delegate
+The Identity of the delegate to add. Can be specified using the ObjectId, the SIP address or the e-mail address.
+
+A user can have up to 25 delegates.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Default value: None
+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, the SIP address or the e-mail address.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -MakeCalls
+
+Specifies whether delegate is allowed to make calls on behalf of the specified user.
+
+```yaml
+Type: System.Boolean
+Parameter Sets: All
+Aliases:
+
+Required: True
+Default value: False
+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.
+
+```yaml
+Type: System.Boolean
+Parameter Sets: All
+Aliases:
+
+Required: True
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ReceiveCalls
+
+Specifies whether delegate is allowed to receive calls on behalf of the specified user.
+
+```yaml
+Type: System.Boolean
+Parameter Sets: All
+Aliases:
+
+Required: True
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction,
+and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+
+## NOTES
+The cmdlet is available in Teams PowerShell module 3.0.1-preview.
+
+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.
+
+## RELATED LINKS
+[Get-CsUserCallingSettings](Get-CsUserCallingSettings.md)
+
+[Set-CsUserCallingDelegate](Set-CsUserCallingDelegate.md)
+
+[Remove-CsUserCallingDelegate](Remove-CsUserCallingDelegate.md)

teams/teams-ps/teams/Remove-CsUserCallingDelegate.md

@@ -0,0 +1,94 @@
+---
+external help file: Microsoft.Open.Teams.CommonLibrary.dll-Help.xml
+Module Name: MicrosoftTeams
+online version: https://docs.microsoft.com/powershell/module/teams/remove-csusercallingdelegate
+applicable: Microsoft Teams
+author: jenstrier
+ms.author: jenstr
+ms.reviewer: 
+manager:
+schema: 2.0.0
+---
+
+# Remove-CsUserCallingDelegate
+
+## SYNOPSIS
+This cmdlet will remove a delegate for calling in Microsoft Teams.
+
+> [!NOTE]
+> **Preview** The use of this cmdlet is in Public Preview.
+  
+## SYNTAX
+
+### Identity (Default)
+```powershell
+Remove-CsUserCallingDelegate -Identity <String> -Delegate <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This cmdlet will remove a delegate for the specified user.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+Remove-CsUserCallingDelegate -Identity [email protected] -Delegate [email protected]
+```
+This example shows removing the delegate [email protected].
+
+
+## PARAMETERS
+
+### -Delegate
+The Identity of the delegate to remove. Can be specified using the ObjectId, the SIP address or the e-mail address.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Identity
+The Identity of the user to remove a delegate for. Can be specified using the ObjectId, the SIP address or the e-mail address.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction,
+and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+
+## NOTES
+The cmdlet is available in Teams PowerShell module 3.0.1-preview.
+
+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.
+
+## RELATED LINKS
+[Get-CsUserCallingSettings](Get-CsUserCallingSettings.md)
+
+[New-CsUserCallingDelegate](New-CsUserCallingDelegate.md)
+
+[Set-CsUserCallingDelegate](Set-CsUserCallingDelegate.md)