Send-RdsUserSessionMessage

모듈:

Microsoft.RDInfra.RDPowershell Module

사용자 세션에 시스템 메시지를 보냅니다.

구문

Default (기본값)

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

Description

Send-RdsUserSessionmessage cmdlet은 지정된 사용자 세션으로 시스템 메시지를 보냅니다. 사용자 세션 ID는 세션 호스트의 컨텍스트 내에서만 고유하기 때문에 다른 세션 호스트 서버가 동일한 사용자 세션 ID를 공유할 수 있습니다. 이 cmdlet을 사용하여 지정하는 세션 호스트 및 세션 ID는 호스트 풀 내에서 세션을 고유하게 식별합니다. 세션 ID가 없으면 메시지가 세션 호스트의 모든 사용자 세션으로 브로드캐스트됩니다.

예제

예제 1: 필요한 모든 정보를 제공하여 사용자 세션에 메시지 보내기

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

이 명령은 지정된 사용자 세션에 메시지를 보냅니다. 이 명령을 사용하려면 필요한 모든 정보를 제공하기 위해 이전에 사용자 세션을 조회했어야 합니다. NoUserPrompt 스위치 없이 Send-RdsUserSessionMessage cmdlet을 실행하면 메시지를 보낼 것인지 확인하라는 메시지가 표시됩니다.

예제 2: 사용자 세션을 검색하여 사용자에게 메시지 보내기

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

이 명령은 Get-RdsUserSession cmdlet을 사용하여 특정 사용자의 세션을 검색한 다음 Send-RdsUserSessionMessage cmdlet으로 파이프하여 사용자 세션에 메시지를 보냅니다. NoUserPrompt 스위치와 함께 Send-RdsUserSessionMessage cmdlet을 실행하면 메시지 보내기를 확인하는 추가 메시지가 표시되지 않습니다.

매개 변수

-HostPoolName

호스트 풀의 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	1
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-MessageBody

사용자 세션에 보낼 메시지의 본문입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	5
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-MessageTitle

사용자 세션에 보낼 메시지의 제목입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	4
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-NoUserPrompt

추가 확인 없이 사용자의 연결을 끊고 싶다는 것을 나타내는 스위치입니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SessionHostName

세션 호스트의 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	2
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-SessionId

메시지를 받을 사용자 세션과 상관 관계가 있는 세션 ID입니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	3
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-TenantName

테넌트 이름입니다.

매개 변수 속성

형식:	String
Default value:	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