Compartilhar via

Instalar o PowerShell no Windows IoT e no Nano Server

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

Implantar no Windows 11 IoT

O Windows 11 IoT Enterprise vem com o Windows PowerShell, que é usado para implantar 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 o PowerShell Remoting, você obtém uma mensagem de erro e é desconectado do dispositivo. O PowerShell precisa reiniciar o WinRM. Agora, você pode conectar-se ao ponto de extremidade 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 o Windows PowerShell quando você inclui IOT_POWERSHELL recurso. Use o Windows PowerShell para implantar o PowerShell 7 usando as mesmas etapas que o 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 o recurso 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 à imagem.

Implantação no Nano Server

Estas instruções pressupõem que o Nano Server é um sistema operacional sem periféricos que tem uma versão do PowerShell já em execução. Confira mais informações na documentação do Construtor de Imagens do Nano Server.

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 na imagem montada.
  2. Online – transfira o arquivo zip em uma sessão do PowerShell e descompacte-o em seu local escolhido.

Em ambos os casos, você precisa do pacote de versão ZIP do Windows x64. Execute os comandos em uma instância de "Administrador" do PowerShell.

Implantação offline do PowerShell

  1. Use o utilitário zip favorito para descompactar o pacote para um diretório na 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 com suporte do Windows

A Microsoft dá suporte ao PowerShell até que o PowerShell chegue ao fim do suporte ou a versão do Windows chegue ao 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 Registro de Artefatos da Microsoft.

Essas 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, a fim de garantir que as atualizações de segurança mais recentes sejam aplicadas.

Essas imagens são fornecidas para fins de teste. Se você precisar de uma imagem do Docker para uma carga de trabalho de produção, deverá criar e manter a sua própria.

Observação

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

Você pode verificar qual versão está usando ao executar winver.exe.

Suporte à instalação

A Microsoft dá suporte aos 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 dar 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 de que você precisa. 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 são encontrados na seção Recursos da página de lançamento. A seção Ativos pode estar recolhida e, portanto, talvez você precise clicar para expandi-la.

  • Last updated on