Aracılığıyla paylaş


Send-RdsUserSessionMessage

Kullanıcı oturumuna sistem iletisi gönderir.

Syntax

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

Description

Send-RdsUserSessionmessage cmdlet'i belirtilen kullanıcı oturumuna bir sistem iletisi gönderir. Kullanıcı oturum kimliği yalnızca oturum konağı bağlamında benzersiz olduğundan, farklı bir oturum ana bilgisayarı sunucusu aynı kullanıcı oturum kimliğini paylaşabilir. Bu cmdlet'i kullanarak belirttiğiniz oturum konağı ve oturum kimliği, konak havuzundaki bir oturumu benzersiz olarak tanımlar. Oturum kimliği yoksa, ileti oturum konağındaki tüm kullanıcı oturumlarına yayınlanır.

Örnekler

Örnek 1: Tüm gerekli bilgileri sağlayarak bir kullanıcı oturumuna ileti gönderme

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

Bu komut belirtilen kullanıcı oturumuna bir ileti gönderir. Bu komut, gerekli tüm bilgileri sağlamak için kullanıcı oturumunu daha önce aramış olmanız gerekir. Send-RdsUserSessionMessage cmdlet'ini NoUserPrompt anahtarı olmadan çalıştırarak, iletiyi göndermeyi onaylamanız istenir.

Örnek 2: Kullanıcı oturumlarını arayarak kullanıcıya ileti gönderme

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

Bu komut, belirli bir kullanıcının oturumunu aramak için Get-RdsUserSession cmdlet'ini kullanır, ardından kullanıcı oturumuna ileti göndermek için Send-RdsUserSessionMessage cmdlet'ine aktarır. NoUserPrompt anahtarıyla Send-RdsUserSessionMessage cmdlet'ini çalıştırarak, iletiyi göndermeyi onaylamanız için ek bir istem almazsınız.

Parametreler

-HostPoolName

Konak havuzunun adı.

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

-MessageBody

Kullanıcı oturumuna göndermek istediğiniz iletinin gövdesi.

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

-MessageTitle

Kullanıcı oturumuna göndermek istediğiniz iletinin başlığı.

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

-NoUserPrompt

Ek onay olmadan kullanıcının bağlantısını kesmek istediğinizi belirten anahtar.

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

-SessionHostName

Oturum konağı adı.

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

-SessionId

İletiyi alacak kullanıcı oturumuyla ilişkili oturum kimliği.

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

-TenantName

Kiracının adı.

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

Girişler

System.String

System.Int32

Çıkışlar

System.Object