Send-xRDS_Host_Message.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
function Send-xRDS_Host_Message {

<#
    .DESCRIPTION
    Sends message to ALL users on HOST server.
  
    .PARAMETER Broker
    -ConnectionBroker - FQDN of RDS ConnectionBroker.
 
    .PARAMETER Message
    -Message - Message text to display for users.
 
    .PARAMETER Credential
    -Credential [Optional] - Query RDS Connection Broker resources under provided credentials.
 
    PARAMETER DisplayMessageSeconds
    -DisplayMessageSeconds [Optional] - Message display time in seconds (Default value is equivalent of 5 minutes).
 
    .EXAMPLE
    # Send message to all users on selected RDS Host servers:
    Send-xRDS_Host_Message -ConnectionBroker ardscbl01.adatum.labnet -Message "Server will shut down in 10 minutes for maintenance. Please log out from your session and log back again to be redirected into another Session Host."
 
#>



    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true)][string]$ConnectionBroker,    
        [Parameter(Mandatory=$true)][string]$Message,
        [Int]$DisplayMessageSeconds = 300,
        [PSCredential]$Credential
    )      

    $Collection = Get-xRDS_CollectionsList -ConnectionBroker $ConnectionBroker -Credential $Credential

    Try {

    $ActiveManagementServer =  (Invoke-WmiMethod -ComputerName $ConnectionBroker -Class "Win32_RDMSEnvironment" -Namespace "root\CIMV2\rdms" -Name "GetActiveServer").ServerName

    $SelectedServers = Get-WmiObject -ComputerName $ActiveManagementServer -Credential $Credential -Query "SELECT ServerName,LoadIndicator,NumberOfSessions,NumPendRedir,ServerWeight,SingleSessionMode FROM Win32_SessionDirectoryServer" | select `
    @{Label="Host";Expression={$_.ServerName}}, @{Label="Collections";Expression={$Collection[$_.ServerName]}},@{Label="Sessions";Expression={$_.NumberOfSessions}}, `
    @{Label="LoadIndicator";Expression={$_.LoadIndicator}},@{Label="ServerWeight";Expression={$_.ServerWeight}},`
    @{Label="NumPendRedir";Expression={$_.NumPendRedir}},@{Label="SingleSessionMode";Expression={$_.SingleSessionMode}}    | sort Host | Out-GridView -PassThru -Title "Host Message (Select Servers)"

    If ($SelectedServers.Host.Count -le 0) {Write-Host "No hosts have been selected." -ForegroundColor Cyan }
    else { Write-Host "Message: $Message Will display $DisplayMessageSeconds seconds on folowing servers:" -ForegroundColor Cyan ; $SelectedServers.Host | foreach {Write-Host "$_" -ForegroundColor Cyan ; start-process msg "* /SERVER:$_ /TIME:$DisplayMessageSeconds $Message" -WindowStyle Hidden}}

    } Catch {Write-host $_.Exception.message -ForegroundColor Red}
}