Send-RdsUserSessionMessage

الوحدة النمطية:

Microsoft.RDInfra.RDPowershell

يرسل رسالة نظام إلى جلسة عمل مستخدم.

بناء الجملة

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

الوصف

يرسل الأمر cmdlet Send-RdsUserSessionmessage رسالة نظام إلى جلسة عمل مستخدم محددة. نظرا لأن معرف جلسة عمل المستخدم فريد فقط في سياق مضيف الجلسة، يمكن لخادم مضيف جلسة عمل مختلف مشاركة نفس معرف جلسة المستخدم. يحدد مضيف الجلسة ومعرف الجلسة الذي تحدده باستخدام cmdlet هذا جلسة عمل بشكل فريد داخل تجمع مضيف. إذا لم يكن معرف الجلسة موجودا، بث الرسالة إلى جميع جلسات عمل المستخدم على مضيف الجلسة.

أمثلة

مثال 1: إرسال رسالة إلى جلسة مستخدم من خلال توفير جميع المعلومات المطلوبة

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

يرسل هذا الأمر رسالة إلى جلسة عمل المستخدم المحددة. يتطلب هذا الأمر البحث عن جلسة عمل المستخدم مسبقا لتوفير كافة المعلومات المطلوبة. من خلال تشغيل Send-RdsUserSessionMessage cmdlet بدون مفتاح NoUserPrompt، سيطلب منك تأكيد إرسال الرسالة.

مثال 2: إرسال رسالة إلى مستخدم من خلال البحث عن جلسة المستخدم الخاصة به

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

يستخدم هذا الأمر الأمر cmdlet Get-RdsUserSession للبحث عن جلسة عمل المستخدم المحدد، ثم يقوم بتثبيتها في Send-RdsUserSessionMessage cmdlet لإرسال رسالة إلى جلسة عمل المستخدم. من خلال تشغيل Send-RdsUserSessionMessage cmdlet باستخدام مفتاح NoUserPrompt، لن تتلقى أي مطالبة إضافية لتأكيد إرسال الرسالة.

المعلمات

-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

معرف جلسة العمل المرتبط بجلسة المستخدم التي ستتلقى الرسالة.

النوع:	Int32
Position:	3
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	True
قبول أحرف البدل:	False

-TenantName

اسم المستأجر.

النوع:	String
Position:	0
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	True
قبول أحرف البدل:	False

الإدخالات

System.String

System.Int32

المخرجات

System.Object