Delen via


PowerShell installeren in Windows IoT en Nano Server

In dit artikel wordt beschreven hoe u PowerShell installeert op Windows IoT en Nano Server.

Implementeren in Windows 11 IoT

Windows 11 IoT Enterprise wordt geleverd met Windows PowerShell, dat wordt gebruikt om PowerShell 7 te implementeren.

# Replace the placeholder information for the following variables:
$deviceip = '<device ip address>'
$zipfile = 'PowerShell-7.5.4-win-arm64.zip'
$downloadfolder = 'U:\Users\Administrator\Downloads'
# The download location is local to the device.
# There should be enough space for the zip file and the unzipped contents.

# Create PowerShell session to target device
Set-Item -Path WSMan:\localhost\Client\TrustedHosts $deviceip
$S = New-PSSession -ComputerName $deviceIp -Credential Administrator
# Copy the ZIP package to the device
Copy-Item $zipfile -Destination $downloadfolder -ToSession $S

#Connect to the device and expand the archive
Enter-PSSession $S
Set-Location U:\Users\Administrator\Downloads
Expand-Archive .\PowerShell-7.5.4-win-arm64.zip

# Set up remoting to PowerShell 7
Set-Location .\PowerShell-7.5.4-win-arm64
# Be sure to use the -PowerShellHome parameter otherwise it tries to create a new
# endpoint with Windows PowerShell 5.1
.\Install-PowerShellRemoting.ps1 -PowerShellHome .

Wanneer u Externe communicatie van PowerShell instelt, krijgt u een foutbericht en wordt de verbinding met het apparaat verbroken. PowerShell moet WinRM opnieuw starten. U kunt nu verbinding maken met het PowerShell 7-eindpunt op het apparaat.


# Be sure to use the -Configuration parameter. If you omit it, you connect to Windows PowerShell 5.1
Enter-PSSession -ComputerName $deviceIp -Credential Administrator -Configuration PowerShell.7.5.4

Windows 11 IoT Core voegt Windows PowerShell toe wanneer u IOT_POWERSHELL functie opneemt. Gebruik Windows PowerShell om PowerShell 7 te implementeren met dezelfde stappen als Windows 11 IoT Enterprise.

Als u de nieuwste versie van PowerShell wilt toevoegen aan de verzendafbeelding, gebruikt u de opdracht Import-PSCoreRelease om het pakket op te nemen in het werkgebied en voegt u de functie OPENSRC_POWERSHELL toe aan uw afbeelding.

Opmerking

Voor ARM64-architectuur wordt Windows PowerShell niet toegevoegd wanneer u IOT_POWERSHELL opneemt. De zip-installatie werkt dus niet. U moet de opdracht gebruiken Import-PSCoreRelease om deze toe te voegen aan de afbeelding.

Implementeren op Nano Server

In deze instructies wordt ervan uitgegaan dat de Nano Server een 'headless' besturingssysteem is met een versie van PowerShell die er al op wordt uitgevoerd. Zie de documentatie van Nano Server Image Builder voor meer informatie.

Binaire PowerShell-bestanden kunnen worden geïmplementeerd met behulp van twee verschillende methoden.

  1. Offline: koppel de Nano Server-VHD aan en pak de inhoud van het zip-bestand uit naar de door u gekozen locatie binnen de gekoppelde image.
  2. Online: draag het zip-bestand over via een PowerShell-sessie en pak het uit op de door u gekozen locatie.

In beide gevallen hebt u het Windows x64 ZIP-releasepakket nodig. Voer de opdrachten uit in een Administrator-exemplaar van PowerShell.

Offline-implementatie van PowerShell

  1. Gebruik uw favoriete compressieprogramma om het pakket uit te pakken in een map binnen de gemounte Nano Server-image.
  2. Ontkoppel de image en start hem op.
  3. Maak verbinding met het ingebouwde exemplaar van Windows PowerShell.

Online-implementatie van PowerShell

Implementeer PowerShell in Nano Server met behulp van de volgende stappen.

# Replace the placeholder information for the following variables:
$ipaddr = '<Nano Server IP address>'
$credential = Get-Credential # <An Administrator account on the system>
$zipfile = 'PowerShell-7.5.4-win-x64.zip'
# Connect to the built-in instance of Windows PowerShell
$session = New-PSSession -ComputerName $ipaddr -Credential $credential
# Copy the file to the Nano Server instance
Copy-Item $zipfile C:\ -ToSession $session
# Enter the interactive remote session
Enter-PSSession $session
# Extract the ZIP file
Expand-Archive -Path C:\PowerShell-7.5.4-win-x64.zip -DestinationPath 'C:\Program Files\PowerShell 7'

Ondersteunde versies van Windows

Microsoft ondersteunt PowerShell totdat PowerShell het einde van de ondersteuning bereikt of de versie van Windows end-of-support bereikt.

De Docker-installatiekopieën voor de .NET SDK bevatten de nieuwste versies van PowerShell. Deze afbeeldingen zijn beschikbaar via het Microsoft Artifact Registry.

Deze installatiekopieën hebben mogelijk niet de meest recente beveiligingsupdates. Microsoft raadt u aan de besturingssysteempakketten bij te werken naar de nieuwste versie om ervoor te zorgen dat de meest recente beveiligingsupdates worden toegepast.

Deze afbeeldingen worden geleverd voor testdoeleinden. Als u een Docker-afbeelding voor een productiewerkbelasting nodig hebt, moet u uw eigen afbeeldingen bouwen en onderhouden.

Opmerking

Ondersteuning voor een specifieke versie van Windows wordt bepaald door het Microsoft Ondersteuning levenscyclusbeleid. Voor meer informatie, zie:

U kunt de versie controleren die u gebruikt door uit te voeren winver.exe.

Installatieondersteuning

Microsoft ondersteunt de installatiemethoden in dit document. Er kunnen andere installatiemethoden van derden beschikbaar zijn vanuit andere bronnen. Hoewel deze hulpprogramma's en methoden mogelijk werken, kan Microsoft deze methoden niet ondersteunen.

Opmerking

De installatieopdrachten in dit artikel zijn bedoeld voor de nieuwste stabiele versie van PowerShell. Als u een andere versie van PowerShell wilt installeren, past u de opdracht aan zodat deze overeenkomt met de versie die u nodig hebt. Met de volgende koppelingen gaat u naar de meest recente releasepagina voor elke versie op GitHub.

Downloadkoppelingen voor elk pakket vindt u in de sectie Assets van de releasepagina. De sectie Assets kan worden samengevouwen, dus mogelijk moet u erop klikken om deze uit te vouwen.