diff --git a/BoxStarter.Common/Invoke-FromTask.ps1 b/BoxStarter.Common/Invoke-FromTask.ps1 index 47486f61..c1b756dd 100644 --- a/BoxStarter.Common/Invoke-FromTask.ps1 +++ b/BoxStarter.Common/Invoke-FromTask.ps1 @@ -29,7 +29,7 @@ Invoke-FromTask Install-WindowsUpdate -AcceptEula This will install Windows Updates in a scheduled task .EXAMPLE -Invoke-FromTask "DISM /Online /Online /NoRestart /Enable-Feature /Telnet-Client" -IdleTimeout 20 +Invoke-FromTask "DISM /Online /NoRestart /Enable-Feature:TelnetClient" -IdleTimeout 20 This will use DISM.exe to install the telnet client and will kill the task if it becomes idle for more that 20 seconds. diff --git a/Web/InstallingPackages.cshtml b/Web/InstallingPackages.cshtml index 4a36f6a4..6d094bb3 100644 --- a/Web/InstallingPackages.cshtml +++ b/Web/InstallingPackages.cshtml @@ -166,6 +166,6 @@ When using a Windows PowerShell session instead of ComputerName or ConnectionURI

Installation Failures

Remote installations performed via PowerShell Remoting can sometimes fail. The symptoms of such failures can manifest themselves in a variety of ways and do not fail in a consistent manner. Boxstarter makes great effort to ensure the success of remote installs by leveraging scheduled tasks when it sees certain install activities. Boxstarter intercepts all calls to MSIEXEC, DISM (Installer for "Windows Features") and Windows Update. It is possible for more involved installation scripts to perform these operations in such a way that Boxstarter will not be able to intercept. If you suspect that your installation is failing due to using a remote session, you can use Boxstarter's Invoke-FromTask command to manually wrap your install in a scheduled task and thereby use a Local token.

-Invoke-FromTask "DISM /Online /NoRestart /Enable-Feature /Telnet-Client" -IdleTimeout 20
+Invoke-FromTask "DISM /Online /NoRestart /Enable-Feature:TelnetClient" -IdleTimeout 20
 
-

This will run the DISM command to install the Telnet client in a scheduled task, and will kill the process if it becomes idle for more than 20 seconds. The scheduled task will always run with elevated privileges and be invoked immediately. If the same user whose credentials created the task is logged on to an active session, the scheduled task will run interactively on the remote machine. All console output from the scheduled task will be intercepted by Boxstarter and rendered to the user's console.

\ No newline at end of file +

This will run the DISM command to install the Telnet client in a scheduled task, and will kill the process if it becomes idle for more than 20 seconds. The scheduled task will always run with elevated privileges and be invoked immediately. If the same user whose credentials created the task is logged on to an active session, the scheduled task will run interactively on the remote machine. All console output from the scheduled task will be intercepted by Boxstarter and rendered to the user's console.