Partilhar via

Instale o PowerShell no Windows IoT e no Nano Server

Este artigo descreve como instalar o PowerShell no Windows IoT e no Nano Server.

Implementar no Windows 11 IoT

O Windows 11 IoT Enterprise vem com o Windows PowerShell, que é usado para implementar o PowerShell 7.

# 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 .

Ao configurar a comunicação remota do PowerShell, você recebe uma mensagem de erro e é desconectado do dispositivo. O PowerShell precisa reiniciar o WinRM. Agora você pode se conectar ao endpoint do PowerShell 7 no dispositivo.


# 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

O Windows 11 IoT Core adiciona Windows PowerShell quando inclui IOT_POWERSHELL funcionalidade. Use o Windows PowerShell para implementar o PowerShell 7 usando os mesmos passos do Windows 11 IoT Enterprise.

Para adicionar o PowerShell mais recente na imagem de envio, use o comando Import-PSCoreRelease para incluir o pacote na área de trabalho e adicionar a funcionalidade OPENSRC_POWERSHELL à sua imagem.

Observação

Para a arquitetura ARM64, o Windows PowerShell não é adicionado quando você inclui IOT_POWERSHELL. Portanto, a instalação baseada em zip não funciona. Você precisa usar o comando Import-PSCoreRelease para adicioná-lo na imagem.

Implementar no Nano Server

Estas instruções pressupõem que o Nano Server é um sistema operacional "sem cabeça" que já tem uma versão do PowerShell em execução nele. Para obter mais informações, consulte a documentação do Nano Server Image Builder .

Os binários do PowerShell podem ser implantados usando dois métodos diferentes.

  1. Offline - Monte o VHD do Nano Server e descompacte o conteúdo do arquivo zip para o local escolhido dentro da imagem montada.
  2. Online - Transfira o arquivo zip por uma sessão do PowerShell e descompacte-o no local escolhido.

Em ambos os casos, precisa do Pacote ZIP de lançamento do Windows x64. Execute os comandos em uma instância "Administrador" do PowerShell.

Implantação offline do PowerShell

  1. Use seu utilitário zip favorito para descompactar o pacote para um diretório dentro da imagem montada do Nano Server.
  2. Desmonte a imagem e inicialize-a.
  3. Conecte-se à instância interna do Windows PowerShell.

Implantação online do PowerShell

Implante o PowerShell no Nano Server usando as etapas a seguir.

# 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'

Versões suportadas do Windows

A Microsoft oferece suporte ao PowerShell até que o PowerShell atinja o fim do suporte ou a versão do Windows atinja o fim do suporte.

As imagens do Docker para o SDK do .NET contêm as versões mais recentes do PowerShell. Essas imagens estão disponíveis no Microsoft Artifact Registry.

Estas imagens podem não ter as atualizações de segurança mais recentes. A Microsoft recomenda que você atualize os pacotes do sistema operacional para a versão mais recente para garantir que as atualizações de segurança mais recentes sejam aplicadas.

Estas imagens são fornecidas para fins de teste. Se você precisar de uma imagem do Docker para uma carga de trabalho de produção, crie e mantenha a sua própria.

Observação

O suporte para uma versão específica do Windows é determinado pelas políticas de ciclo de vida do suporte da Microsoft. Para obter mais informações, consulte:

Você pode verificar a versão que você está usando executando winver.exe.

Suporte à instalação

A Microsoft suporta os métodos de instalação neste documento. Pode haver outros métodos de instalação de terceiros disponíveis de outras fontes. Embora essas ferramentas e métodos possam funcionar, a Microsoft não pode oferecer suporte a esses métodos.

Observação

Os comandos de instalação neste artigo são para a versão estável mais recente do PowerShell. Para instalar uma versão diferente do PowerShell, ajuste o comando para corresponder à versão necessária. Os links a seguir direcionam você para a página de lançamento mais recente para cada versão no GitHub.

Os links de download para cada pacote encontram-se na secção Recursos da página de lançamento. A seção Ativos pode estar fechada, portanto, talvez seja necessário clicar em "expandir".

  • Last updated on