Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions docs/installation/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand Down