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