From ed4158e929ad847ce2f71ddc94afac413e8c372f Mon Sep 17 00:00:00 2001 From: Renato Pereira Date: Tue, 30 Sep 2025 20:15:35 -0400 Subject: [PATCH 1/3] update CsUserCallingDelegate docs --- .vscode/settings.json | 5 +++ .../Get-CsUserCallingSettings.md | 20 +++++---- .../New-CsUserCallingDelegate.md | 42 ++++++++++++++++++- .../Set-CsUserCallingDelegate.md | 42 ++++++++++++++++++- 4 files changed, 97 insertions(+), 12 deletions(-) create mode 100644 .vscode/settings.json diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000000..a490b614a3 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,5 @@ +{ + "githubPullRequests.ignoredPullRequestBranches": [ + "main" + ] +} \ No newline at end of file diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md index 4ba4c9a51b..312c56cc1e 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsUserCallingSettings.md @@ -148,10 +148,12 @@ GroupNotificationOverride : Ring (Get-CsUserCallingSettings -Identity user7@contoso.com).Delegates ``` ```output -Id : sip:user8@contoso.com -MakeCalls : True -ManageSettings : True -ReceiveCalls : True +Id : sip:user8@contoso.com +MakeCalls : True +ManageSettings : True +ReceiveCalls : True +PickUpHeldCalls : True +JoinActiveCalls : True ``` This example shows that user7@contoso.com has simultaneous ringing set to his/her delegates (ForwardingTargetType). User8@contoso.com is the only delegate @@ -182,10 +184,12 @@ GroupNotificationOverride : Ring (Get-CsUserCallingSettings -Identity user9@contoso.com).Delegators ``` ```output -Id : sip:user10@contoso.com -MakeCalls : True -ManageSettings : True -ReceiveCalls : True +Id : sip:user10@contoso.com +MakeCalls : True +ManageSettings : True +ReceiveCalls : True +PickUpHeldCalls : True +JoinActiveCalls : True ``` This example shows that user9@contoso.com is a delegate of user10@contoso.com (Delegators) and that user10@contoso.com has given user9@contoso.com all the diff --git a/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md b/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md index 90b9401956..87ff12d342 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md @@ -19,7 +19,7 @@ This cmdlet will add a new delegate for calling in Microsoft Teams. ``` New-CsUserCallingDelegate -Identity -Delegate -MakeCalls -ManageSettings - -ReceiveCalls [-HttpPipelinePrepend ] [] + -ReceiveCalls -PickUpHeldCalls -JoinActiveCalls [-HttpPipelinePrepend ] [] ``` ## DESCRIPTION @@ -29,7 +29,7 @@ This cmdlet adds a new delegate with given permissions for the specified user. ### Example 1 ```powershell -New-CsUserCallingDelegate -Identity user1@contoso.com -Delegate user2@contoso.com -MakeCalls $true -ReceiveCalls $true -ManageSettings $true +New-CsUserCallingDelegate -Identity user1@contoso.com -Delegate user2@contoso.com -MakeCalls $true -ReceiveCalls $true -ManageSettings $true -PickUpHeldCalls $true -JoinActiveCalls $true ``` ## PARAMETERS @@ -129,6 +129,44 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -PickUpHeldCalls + +Specifies whether delegate is allowed to pick up calls on behalf of the specified user. + +>[!NOTE] +>This parameter is currently in development and changing it does not change the behavior of the User Delegate. + +```yaml +Type: System.Boolean +Parameter Sets: All +Aliases: + +Required: True +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JoinActiveCalls + +Specifies whether delegate is allowed to join active calls on behalf of the specified user. + +>[!NOTE] +>This parameter is currently in development and changing it does not change the behavior of the User Delegate. + +```yaml +Type: System.Boolean +Parameter Sets: All +Aliases: + +Required: True +Position: Named +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](http://go.microsoft.com/fwlink/?LinkID=113216). diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md b/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md index 57879dac3b..f496b8925a 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md @@ -19,7 +19,7 @@ This cmdlet will change permissions for a delegate for calling in Microsoft Team ``` Set-CsUserCallingDelegate -Identity -Delegate [-MakeCalls ] - [-ManageSettings ] [-ReceiveCalls ] [-HttpPipelinePrepend ] + [-ManageSettings ] [-ReceiveCalls ] [-PickUpHeldCalls ] [-JoinActiveCalls ] [-HttpPipelinePrepend ] [] ``` @@ -30,7 +30,7 @@ This cmdlet can change the permissions assigned to a delegate for the specified ### Example 1 ```powershell -Set-CsUserCallingDelegate -Identity user1@contoso.com -Delegate user2@contoso.com -MakeCalls $false -ReceiveCalls $true -ManageSettings $false +Set-CsUserCallingDelegate -Identity user1@contoso.com -Delegate user2@contoso.com -MakeCalls $false -ReceiveCalls $true -ManageSettings $false -PickUpHeldCalls $true -JoinActiveCalls $true ``` This example shows setting the permissions for user1@contoso.com's delegate user2@contoso.com. @@ -138,6 +138,44 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -PickUpHeldCalls + +Specifies whether delegate is allowed to pick up calls on behalf of the specified user. + +>[!NOTE] +>This parameter is currently in development and changing it does not change the behavior of the User Delegate. + +```yaml +Type: System.Boolean +Parameter Sets: All +Aliases: + +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JoinActiveCalls + +Specifies whether delegate is allowed to join active calls on behalf of the specified user. + +>[!NOTE] +>This parameter is currently in development and changing it does not change the behavior of the User Delegate. + +```yaml +Type: System.Boolean +Parameter Sets: All +Aliases: + +Required: False +Position: Named +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](http://go.microsoft.com/fwlink/?LinkID=113216). From e90571c4afe2c42eadbdbc39e01161651cfc4194 Mon Sep 17 00:00:00 2001 From: Renato Pereira Date: Tue, 30 Sep 2025 21:53:58 -0400 Subject: [PATCH 2/3] Delete .vscode/settings.json --- .vscode/settings.json | 5 ----- 1 file changed, 5 deletions(-) delete mode 100644 .vscode/settings.json diff --git a/.vscode/settings.json b/.vscode/settings.json deleted file mode 100644 index a490b614a3..0000000000 --- a/.vscode/settings.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "githubPullRequests.ignoredPullRequestBranches": [ - "main" - ] -} \ No newline at end of file From 3d9264e1e421d0603a1218ef73a3863626cfeada Mon Sep 17 00:00:00 2001 From: Renato Pereira Date: Wed, 1 Oct 2025 10:39:33 -0400 Subject: [PATCH 3/3] remove internal parameter documentation - it should not be in public docs --- .../New-CsUserCallingDelegate.md | 17 +---------------- .../Set-CsUserCallingDelegate.md | 18 +----------------- 2 files changed, 2 insertions(+), 33 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md b/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md index 87ff12d342..9d977e8cf4 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsUserCallingDelegate.md @@ -19,7 +19,7 @@ This cmdlet will add a new delegate for calling in Microsoft Teams. ``` New-CsUserCallingDelegate -Identity -Delegate -MakeCalls -ManageSettings - -ReceiveCalls -PickUpHeldCalls -JoinActiveCalls [-HttpPipelinePrepend ] [] + -ReceiveCalls -PickUpHeldCalls -JoinActiveCalls [] ``` ## DESCRIPTION @@ -51,21 +51,6 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -HttpPipelinePrepend -{{ Fill HttpPipelinePrepend Description }} - -```yaml -Type: Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Runtime.SendAsyncStep[] -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -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 or the SIP address. diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md b/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md index f496b8925a..7e4943284c 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsUserCallingDelegate.md @@ -19,8 +19,7 @@ This cmdlet will change permissions for a delegate for calling in Microsoft Team ``` Set-CsUserCallingDelegate -Identity -Delegate [-MakeCalls ] - [-ManageSettings ] [-ReceiveCalls ] [-PickUpHeldCalls ] [-JoinActiveCalls ] [-HttpPipelinePrepend ] - [] + [-ManageSettings ] [-ReceiveCalls ] [-PickUpHeldCalls ] [-JoinActiveCalls ] [] ``` ## DESCRIPTION @@ -60,21 +59,6 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -HttpPipelinePrepend -{{ Fill HttpPipelinePrepend Description }} - -```yaml -Type: Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Runtime.SendAsyncStep[] -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -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 or the SIP address.