Send-RdsUserSessionMessage

  • Referencia
Modul:
WindowsVirtualDesktopPowershell

Rendszerüzenetet küld egy felhasználói munkamenetnek.

Syntax

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

Description

A Send-RdsUserSessionmessage parancsmag rendszerüzenetet küld egy adott felhasználói munkamenetnek. Mivel a felhasználói munkamenet-azonosító csak egy munkamenetgazda környezetében egyedi, egy másik munkamenetgazda-kiszolgáló is megoszthatja ugyanazt a felhasználói munkamenet-azonosítót. Az ezzel a parancsmaggal megadott munkamenetgazda és munkamenet-azonosító egyedileg azonosít egy munkamenetet egy gazdagépkészleten belül. Ha a munkamenet-azonosító nincs megadva, akkor az üzenetet a rendszer a munkamenetgazda összes felhasználói munkamenetére szórja.

Példák

1. példa: Üzenet küldése felhasználói munkamenetnek az összes szükséges információ megadásával

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

Ez a parancs üzenetet küld a megadott felhasználói munkamenetnek. Ez a parancs megköveteli, hogy korábban megkeresse a felhasználói munkamenetet az összes szükséges információ megadásához. Ha a NoUserPrompt kapcsoló nélkül futtatja a Send-RdsUserSessionMessage parancsmagot, a rendszer megkéri, hogy erősítse meg az üzenet küldését.

2. példa: Üzenet küldése egy felhasználónak a felhasználói munkamenet megkeresésével

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

Ez a parancs a Get-RdsUserSession parancsmagot használja az adott felhasználó munkamenetének kereséséhez, majd a Send-RdsUserSessionMessage parancsmagba irányítja, hogy üzenetet küldjön a felhasználói munkamenetnek. Ha a NoUserPrompt kapcsolóval futtatja a Send-RdsUserSessionMessage parancsmagot, nem kap további kérést az üzenet elküldéséhez.

Paraméterek

-HostPoolName

A gazdagépkészlet neve.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MessageBody

A felhasználói munkamenetbe elküldeni kívánt üzenet törzse.

Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MessageTitle

A felhasználói munkamenetbe küldeni kívánt üzenet címe.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoUserPrompt

A kapcsoló azt jelzi, hogy további megerősítés nélkül szeretné leválasztani a felhasználót.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionHostName

A munkamenetgazda neve.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SessionId

A munkamenet-azonosító korrelál azzal a felhasználói munkamenetel, amely megkapja az üzenetet.

Type:Int32
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantName

A bérlő neve.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

System.String

System.Int32

Kimenetek

System.Object