Send-RdsUserSessionMessage

参考

模块:: WindowsVirtualDesktopPowershell

将系统消息发送到用户会话。

语法

Send-RdsUserSessionMessage
    [-TenantName] <String>
    [-HostPoolName] <String>
    [-SessionHostName] <String>
    [-SessionId] <Int32>
    [-MessageTitle] <String>
    [-MessageBody] <String>
    [-NoUserPrompt]
    [<CommonParameters>]

说明

Send-RdsUserSessionmessage cmdlet 将系统消息发送到指定的用户会话。由于用户会话 ID 仅在会话主机的上下文中是唯一的，因此不同的会话主机服务器可以共享相同的用户会话 ID。使用此 cmdlet 指定的会话主机和会话 ID 唯一标识主机池中的会话。如果会话 ID 不存在，则消息将广播到会话主机上的所有用户会话。

示例

示例 1：通过提供所有必需信息将消息发送到用户会话

PS C:\> Send-RdsUserSessionMessage -TenantName "contoso" -HostPoolName "contosoHostPool" -SessionHostName "sh1.contoso.com" -SessionId 1 -MessageTitle "Test announcement" -MessageBody "Test message."

此命令将消息发送到指定的用户会话。此命令要求你以前查找用户会话以提供所有必需的信息。通过运行没有 NoUserPrompt 开关的 Send-RdsUserSessionMessage cmdlet，系统会要求你确认发送消息。

示例 2：通过搜索用户会话向用户发送消息

PS C:\> Get-RdsUserSession -TenantName "contoso" -HostPoolName "contosoHostPool" | where { $_.UserPrincipalName -eq "contoso\user1" } | Send-RdsUserSessionMessage -MessageTitle "Test announcement" -MessageBody "Test message." -NoUserPrompt

此命令使用 Get-RdsUserSession cmdlet 搜索特定用户的会话，然后将其管道传递到 Send-RdsUserSessionMessage cmdlet，将消息发送到用户会话。通过使用 NoUserPrompt 开关运行 Send-RdsUserSessionMessage cmdlet，你将不会收到任何其他提示来确认发送消息。

参数

-HostPoolName

主机池的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-MessageBody

要发送到用户会话的消息正文。

类型:	String
Position:	5
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-MessageTitle

要发送到用户会话的消息的标题。

类型:	String
Position:	4
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-NoUserPrompt

该开关指示你希望断开用户的连接，而无需进行任何其他确认。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SessionHostName

会话主机的名称。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SessionId

与将接收消息的用户会话关联的会话 ID。

类型:	Int32
Position:	3
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TenantName

租户的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

System.String

System.Int32

输出

System.Object

通过