Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.

Execute-ProcessAsUser [[-UserName] <String>] [-Path] <String> [[-Parameters] <String>] [-SecureParameters] [[-RunLevel] <String>] [-Wait] [-PassThru] [[-ContinueOnError] <Boolean>]

[]

Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.

-UserName <String>

Logged in Username under which to run the process from. Default is: The active console user. If no console user exists but users are logged in, such as on terminal servers, then the first

logged-in non-console user.

-Path <String>

Path to the file being executed.

-Parameters <String>

Arguments to be passed to the file being executed.

-SecureParameters [<SwitchParameter>]

Hides all parameters passed to the executable from the Toolkit log file.

-RunLevel <String>

Specifies the level of user rights that Task Scheduler uses to run the task. The acceptable values for this parameter are:

`- HighestAvailable: Tasks run by using the highest available privileges (Admin privileges for Administrators). Default Value.

`- LeastPrivilege: Tasks run by using the least-privileged user account (LUA) privileges.

-Wait [<SwitchParameter>]

Wait for the process, launched by the scheduled task, to complete execution before accepting more input. Default is $false.

-PassThru[<SwitchParameter>]

Returns the exit code from this function or the process launched by the scheduled task.

-ContinueOnError <Boolean>

Continue if an error is encountered. Default is $true.

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters.

-------------------------- EXAMPLE 1 --------------------------

PS C:>Execute-ProcessAsUser -UserName 'CONTOSO\User' -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & \"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait`

Execute process under a user account by specifying a username under which to execute it.

-------------------------- EXAMPLE 2 --------------------------

PS C:>Execute-ProcessAsUser -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & \"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait`

Execute process under a user account by using the default active logged in user that was detected when the toolkit was launched.

To see the examples, type: Get-Help Execute-ProcessAsUser -Examples

For more information, type: Get-Help Execute-ProcessAsUser -Detailed

For technical information, type: Get-Help Execute-ProcessAsUser -Full

For online help, type: Get-Help Execute-ProcessAsUser -Online