Skip to content

[Feature]: Send-AzWvdUserSessionMessage to utilise Id property from Get-AzWvdUserSession #18134

Open
@robinmalik

Description

Description of the new feature

Currently, use of Send-AzWvdUserSessionMessage is a touch cumbersome. In order to run it, you need to first get (at least) a session id from Get-AzWvdUserSession -ResourceGroupName RGNAME -HostPoolName HOSTPOOLNAME. Example returned object:

ActiveDirectoryUserName : DOMAIN\user
ApplicationType         : Desktop
CreateTime              : 12/05/2022 11:18:58
Id                      : /subscriptions/GUID/resourcegroups/RGNAME/providers/Microsoft.DesktopVirtualization/hostpools/HOSTPOOLNAME/sessionhosts/SESSIONHOSTNAME.domain.com/usersessions/6
Name                    : HOSTPOOLNAME/SESSIONHOSTNAME.domain.com/6
ObjectId                : 00000000-0000-0000-0000-000000000000
SessionState            : Active
Type                    : Microsoft.DesktopVirtualization/hostpools/sessionhosts/usersessions
UserPrincipalName       : user@domain.com

Based on this output (noting the absense of properties for UserSessionId or SessionHostName), an example of what must be then provided to send a message to a single user:

Send-AzWvdUserSessionMessage -ResourceGroupName RGNAME -HostPoolName HOSTPOOLNAME -SessionHostName SESSIONHOSTNAME.domain.com -UserSessionId 6 -MessageTitle 'This is a message from PowerShell' -messagebody 'Hello!'

This requires parsing properties from the output of Get-AzWvdUserSession for the UserSessionId and SessionHostName.

Proposed implementation details (optional)

The Id property on the object returned from Get-AzWvdUserSession contains enough data to pipe to Send-AzWvdUserSessionMessage; it contains the resource group name, the host pool name, the session host name and the id of the session.

To send a message to all users:

Get-AzWvdUserSession -ResourceGroupName RGNAME -HostPoolName HOSTPOOLNAME | Send-AzWvdUserSessionMessage -MessageTitle 'This is a message from PowerShell' -messagebody 'Hello!'

Failing pipeline support, an additional property could be added to the Send cmdlet, that accepts the Id value from the Get cmdlet.

Get-AzWvdUserSession -ResourceGroupName RGNAME -HostPoolName HOSTPOOLNAME | Foreach-Object { Send-AzWvdUserSessionMessage -NewPropertyName $_.Id -MessageTitle 'This is a message from PowerShell' -messagebody 'Hello!' }

Metadata

Assignees

Labels

DesktopVirtualizationWvd, Windows Virtual DesktopService AttentionThis issue is responsible by Azure service team.customer-reportedfeature-requestThis issue requires a new behavior in the product in order be resolved.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions