Send-RdsUserSessionMessage

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

Microsoft.RDInfra.RDPowershell Module

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

بناء الجملة

Default (افتراضي)

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
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	1
إلزامي:	True
القيمة من مسار معالجة البيانات:	True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-MessageBody

نص الرسالة التي تريد إرسالها إلى جلسة المستخدم.

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	5
إلزامي:	True
القيمة من مسار معالجة البيانات:	True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-MessageTitle

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

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	4
إلزامي:	True
القيمة من مسار معالجة البيانات:	True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-NoUserPrompt

يشير المفتاح إلى رغبتك في فصل المستخدم دون أي تأكيد إضافي.

خصائص المعلمات

النوع:	SwitchParameter
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	Named
إلزامي:	False
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	False
القيمة من الوسائط المتبقية:	False

-SessionHostName

اسم مضيف الجلسة.

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	2
إلزامي:	True
القيمة من مسار معالجة البيانات:	True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-SessionId

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

خصائص المعلمات

النوع:	Int32
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	3
إلزامي:	True
القيمة من مسار معالجة البيانات:	True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-TenantName

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

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	0
إلزامي:	True
القيمة من مسار معالجة البيانات:	True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

CommonParameters

يدعم cmdlet هذا المعلمات الشائعة: -Debug و -ErrorAction و -ErrorVariable و -InformationAction و -InformationVariable و -OutBuffer و -OutVariable و -PipelineVariable و -ProgressAction و -Verbose و -WarningAction و -WarningVariable. لمزيد من المعلومات، راجع about_CommonParameters.

الإدخالات

System.String

System.Int32

المخرجات

System.Object