From 462833b76ed885869f1f42574345cb7a3c167a40 Mon Sep 17 00:00:00 2001
From: Steve Lee <slee@microsoft.com>
Date: Fri, 15 Dec 2017 14:05:20 -0800
Subject: [PATCH] Add instructions to deploy win-arm build on Windows IoT
 (#5682)

---
 docs/installation/windows.md | 42 ++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/docs/installation/windows.md b/docs/installation/windows.md
index c26bcd32bd..3d1dc891f0 100644
--- a/docs/installation/windows.md
+++ b/docs/installation/windows.md
@@ -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).