Send-UserLockPopup
Sends a pop-up to a session through the UserLock server.
Sends a pop-up to a session through the UserLock server.
Send-UserLockPopup [-UserName] <string[]> [-Message] <string> [-Title <string>] [-UserLockServerName <string>] [-PassThru] [-Force] [-Confirm] [-WhatIf][<CommonParameters>]
Send-UserLockPopup [-Name] <string[]> [-Message] <string> [-Title <string>] [-UserLockServerName <string>] [-PassThru] [-Force] [-Confirm] [-WhatIf][<CommonParameters>]
Send-UserLockPopup [-ComputerName] <string[]> [-Message] <string> [-Title <string>] [-UserLockServerName <string>] [-PassThru] [-Force] [-Confirm] [-WhatIf][<CommonParameters>]
Send-UserLockPopup [-InputObject] <Session[]> [-Message] <string> [-Title <string>] [-UserLockServerName <string>] [-PassThru] [-Force] [-Confirm] [-WhatIf][<CommonParameters>]The Send-UserLockPopup cmdlet sends a pop-up to the interactive session(s) through the UserLock server. Caution: PowerShell 3.0 is required.
Specifies the message of the pop-up.
Required | true |
Position | 1 |
Accepts pipeline input | false |
Accepts wildcard characters | false |
Specifies the title of the pop-up.
Required | false |
Position | 2 |
Accepts pipeline input | false |
Accepts wildcard characters | false |
Specifies the name of the user for which to send a pop-up all sessions. You can type multiple user names (separated by commas). If the name includes escape characters, enclose it in single quotation marks. Single quotation marks tell Windows PowerShell not to interpret any characters as escape sequences. Wildcard characters are permitted.
Required | true |
Position | named |
Accepts pipeline input | true (ByValue, ByPropertyName) |
Accepts wildcard characters | true |
Specifies the name of the session (Universal key name, to uniquely identify it by specifying the type of session) to send a pop-up. You can type multiple session names (separated by commas). If the name includes escape characters, enclose it in single quotation marks. Single quotation marks tell Windows PowerShell not to interpret any characters as escape sequences. Wildcard characters are permitted.
Required | true |
Position | named |
Accepts pipeline input | true (ByValue, ByPropertyName) |
Accepts wildcard characters | true |
Specifies the name of the computer for which to send a pop-up all sessions. You can type multiple computer names (separated by commas). If the path includes escape characters, enclose it in single quotation marks. Single quotation marks tell Windows PowerShell not to interpret any characters as escape sequences. Wildcard characters are permitted.
Required | true |
Position | named |
Accepts pipeline input | true (ByValue, ByPropertyName) |
Accepts wildcard characters | true |
Specifies the session objects that represent sessions to send a pop-up. Enter a variable that contains the session objects or a command that gets the session objects, such as a Get-UserLockSession command. You can also pipe the objects to Lock-UserLockSession.
Required | true |
Position | named |
Accepts pipeline input | true (ByValue) |
Accepts wildcard characters | true |
Specifies the name of the UserLock server. The default is the localhost name.
Required | false |
Position | named |
Accepts pipeline input | false |
Accepts wildcard characters | false |
Default Value | '.' |
Returns the popped up session object(s). By default, this cmdlet does not generate any output.
Required | false |
Position | named |
Accepts pipeline input | false |
Accepts wildcard characters | false |
Sends a pop-up to the session(s) with no confirmation.
Required | false |
Position | named |
Accepts pipeline input | false |
Accepts wildcard characters | false |
Prompts you for confirmation before executing the command.
Required | false |
Position | named |
Accepts pipeline input | false |
Accepts wildcard characters | false |
Describes what would happen if you executed the command without actually executing the command.
Required | false |
Position | named |
Accepts pipeline input | false |
Accepts wildcard characters | false |
For more information about common parameters, type "Get-Help about_commonparameters".
ISDecisions.UserLockLibrary.Session or ISDecisions.UserLockLibrary.UserSession
None or ISDecisions.UserLockLibrary.Session
You can also refer to Send-UserLockPopup by its alias, "sulp". For more information, see about_Aliases. To use Send-UserLockPopup, you must have the "User sessions" UserLock administrative access right. Send a pop-up to RAS or IIS sessions is not supported. Send-UserLockPopup prompts to confirm pop-up by default. To prevent from prompting, use -Force. To use Send-UserLockPopup with ISDecisions.UserLockLibrary.Session objects through the pipeline, you can use the Get-UserLockSession cmdlet.
Send-UserLockPopup -UserName 'Alice', 'Bob' -UserLockServerName MyUlSrvSend a pop-up to all sessions of the 'Alice' and 'Bob' user accounts through the 'MyUlSrv' UserLock server.
Send-UserLockPopup -ComputerName 'MyWrk01' -UserLockServerName MyUlSrvSends a pop-up to all sessions opened on the 'MyWrk01' computer through the 'MyUlSrv' UserLock server.
Send-UserLockPopup -Name 'MyWrk01/0', 'MyWrk05/2' -UserLockServerName MyUlSrvSends a pop-up to 'MyWrk01/0' and 'MyWrk05/2' sessions through the 'MyUlSrv' UserLock server.
$us = guls -UserLockServerName $UserLockServerName | where {$_.SessionCount -gt 0}
Send-UserLockPopup -InputObject $us -userl $UserLockServerName -ForceSends a pop-up to all interactive sessions through the 'MyUlSrv' UserLock server.