Send-RdsUserSessionMessage

Modül:

Microsoft.RDInfra.RDPowershell Module

Bir kullanıcı oturumuna bir sistem mesajı gönderir.

Sözdizimi

Default EnterprisePublishing

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

Description

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

Örnekler

Örnek 1: Gerekli tüm 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 daha önce kullanıcı oturumunu aramış olmanızı gerektirir. Send-RdsUserSessionMessage cmdlet'ini NoUserPrompt anahtarı olmadan çalıştırdığınızda, iletiyi göndermek için onaylamanız istenir.

Örnek 2: Kullanıcı oturumunu arayarak bir 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 ve ardından kullanıcı oturumuna bir ileti göndermek için Send-RdsUserSessionMessage cmdlet'ine aktarır. Send-RdsUserSessionMessage cmdlet'ini NoUserPrompt anahtarıyla çalıştırdığınızda, iletinin gönderilmesini onaylamanız için herhangi bir ek istem almazsınız.

Parametreler

-HostPoolName

Konak havuzunun adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	1
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MessageBody

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	5
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MessageTitle

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	4
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NoUserPrompt

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SessionHostName

Oturum ana bilgisayarının adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	2
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SessionId

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

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	3
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TenantName

Kiracının adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

System.String

System.Int32

Çıkışlar

System.Object