Add instructions to deploy win-arm build on Windows IoT (#5682)

2026-06-08 12:12:50 +00:00 · 2017-12-15 14:05:20 -08:00
parent 57a4cfcac6
commit 462833b76e
1 changed files with 42 additions and 0 deletions
@@ -30,6 +30,48 @@ Be noted that when using the ZIP archive, you won't get the prerequisites check
 So in order for remoting over WinRM to work properly on Windows versions prior to Windows 10,
 you need to make sure the [prerequisites](#prerequisites) are met.

+## Deploying on Windows IoT
+
+Windows IoT already comes with Windows PowerShell which we will use to deploy PowerShell Core 6.
+
+* Create `PSSession` to target device
+
+```powershell
+$s = New-PSSession -ComputerName <deviceIp> -Credential Administrator
+```
+
+* Copy the zip package to the device
+
+```powershell
+# change the destination to however you had partitioned it with sufficient space for the zip and the unzipped contents
+# the path should be local to the device
+Copy-Item .\PowerShell-6.0.0-rc.2-win-arm32.zip -Destination u:\users\administrator\Downloads -ToSession $s
+```
+
+* Connect to the device and expand the archive
+
+```powershell
+Enter-PSSession $s
+cd u:\users\administrator\downloads
+Expand-Archive .\PowerShell-6.0.0-rc.2-win-arm32.zip
+```
+
+* Setup remoting to PowerShell Core 6
+
+```powershell
+cd .\PowerShell-6.0.0-rc.2-win-arm32
+# Be sure to use the -PowerShellHome parameter otherwise it'll try to create a new endpoint with Windows PowerShell 5.1
+.\Install-PowerShellRemoting.ps1 -PowerShellHome .
+# You'll get an error message and will be disconnected from the device because it has to restart WinRM
+```
+
+* Connect to PowerShell Core 6 endpoint on device
+
+```powershell
+# Be sure to use the -Configuration parameter.  If you omit it, you will connect to Windows PowerShell 5.1
+Enter-PSSession -ComputerName <deviceIp> -Credential Administrator -Configuration powershell.6.0.0-rc.2
+```
+
 ## Deploying on Nano Server

 These instructions assume that Windows PowerShell is running on the Nano Server image and that it has been generated by the [Nano Server Image Builder](https://technet.microsoft.com/windows-server-docs/get-started/deploy-nano-server).