Com o Windows PowerShell, pode in­tro­du­zir comandos numa interface de texto para realizar várias tarefas do sistema.

O que é um script do PowerShell?

O Windows PowerShell é uma interface de linha de comandos e uma linguagem de script concebida es­pe­ci­fi­ca­mente para a ad­mi­nis­tra­ção e au­to­ma­ti­za­ção de sistemas ope­ra­ti­vos Windows e produtos Microsoft re­la­ci­o­na­dos. Foi lançado pela primeira vez em 2006 e, desde então, tem de­sem­pe­nhado um papel im­por­tante na ad­mi­nis­tra­ção de sistemas Windows.

Um script do PowerShell consiste numa sequência de cmdlets do PowerShell, funções, variáveis, condições e outras ins­tru­ções des­ti­na­das a au­to­ma­ti­zar processos e tarefas re­cor­ren­tes. Os scripts do PowerShell são guardados em ficheiros de texto com a extensão .ps1. Para os criar, pode utilizar qualquer editor de texto ou a consola In­te­gra­ted Scripting En­vi­ron­ment (ISE) do PowerShell. Para executar o script, abra a consola do PowerShell e introduza o caminho para o ficheiro do script.

In­de­pen­den­te­mente da forma como executar o script, deve cer­ti­fi­car-se de que as políticas de execução de scripts estão con­fi­gu­ra­das cor­re­ta­mente no seu ambiente PowerShell. Por pre­de­fi­ni­ção, em muitos sistemas, a execução de scripts PowerShell está de­sa­ti­vada para minimizar os riscos de segurança. Pode alterar as políticas de execução uti­li­zando o cmdlet Set-Exe­cu­ti­on­Po­licy.

Como criar scripts do PowerShell com o Visual Studio Code

O Visual Studio Code (VS Code) é um popular editor de código gratuito da Microsoft, concebido es­pe­ci­fi­ca­mente para criar scripts e apli­ca­ções. Inclui um potente realce de sintaxe para código PowerShell e suporta o In­tel­li­Sense para preencher au­to­ma­ti­ca­mente o código.

Passo 1. Instale o VS Code

Se ainda não ins­ta­laste o VS Code, podes des­car­regá-lo a partir do site oficial. Seleciona Windows como sistema operativo e faz duplo clique para iniciar o programa de ins­ta­la­ção.

Imagem: Descarga de VS Code
Descarga de VS Code para Windows

Passo 2. Adicione a extensão PowerShell

Para utilizar o PowerShell de forma eficaz no VS Code, deve instalar a extensão oficial do PowerShell da Microsoft. Para tal, aceda à secção «Extensões» no VS Code (ícone na barra lateral esquerda) e procure por «PowerShell». Em al­ter­na­tiva, utilize o atalho [Ctrl] + [Shift] + [X]. Instale a extensão clicando em «Trust Workspace & Install».

Imagem: Extensión de PowerShell
Instalar la extensión de PowerShell para VS Code

Passo 3. Crie o script

Pode abrir um script do PowerShell já existente ou criar um novo se­le­ci­o­nando «Ficheiro» > «Novo ficheiro de texto» e in­tro­du­zindo o nome do ficheiro com a extensão «.ps1» na janela «Guardar como».

Eis um exemplo de código PowerShell que pode ser escrito no ficheiro aberto:

# This is a comment 
$message = "Script to be executed" 
Write-Host $message
powershell

Passo 4. Execute o script

O VS Code inclui um terminal integrado que pode utilizar para executar comandos do PowerShell di­re­ta­mente no ambiente. Abra o terminal clicando em «Terminal» > «New Terminal» e selecione «PowerShell» como tipo de terminal.

Imagem: Terminal VS Code
Se­lec­ci­o­nar terminal en VS Code

Criar o script com o Bloco de Notas

A seguir, vamos mostrar-lhe como criar um script do PowerShell uti­li­zando o editor de texto Bloco de Notas.

Passo 1. Abra o Bloco de Notas

Clique em «Início» ou no ícone do Windows lo­ca­li­zado no canto inferior esquerdo do ambiente de trabalho. Digite**«Bloco de Notas»**na barra de pesquisa e prima a tecla Enter. O editor de texto Bloco de Notas será aberto.

Passo 2. Escreva o código PowerShell

Podes colar o código do PowerShell di­re­ta­mente no Bloco de Notas.

Imagem: Bloc de notas
Introduce el código PowerShell en el Bloc de notas

Clique em «Arquivo» > «Guardar» ou utilize a com­bi­na­ção de teclas [Ctrl] + [S]. Introduza um nome de ficheiro e adicione a extensão «.ps1» para guardar o script como um ficheiro PowerShell. Selecione um local de ar­ma­ze­na­mento no seu com­pu­ta­dor e clique em «Guardar».

Criar scripts do PowerShell com o In­te­gra­ted Scripting En­vi­ron­ment (ISE)

O In­te­gra­ted Scripting En­vi­ron­ment (ISE) do PowerShell é um ambiente de de­sen­vol­vi­mento integrado (IDE) da Microsoft. O ISE do PowerShell está dis­po­ní­vel por pre­de­fi­ni­ção nos sistemas Windows e funciona como um ambiente robusto e fácil de utilizar para o de­sen­vol­vi­mento de scripts do PowerShell. Deve ter em conta que o ISE foi subs­ti­tuído pelo Visual Studio Code (VS Code) no PowerShell 5.0 e versões su­pe­ri­o­res, uma vez que este dispõe de fun­ci­o­na­li­da­des e fle­xi­bi­li­dade adi­ci­o­nais.

Passo 1. Abra o ISE no PowerShell

Clique em «Start» no canto inferior esquerdo do seu ambiente de trabalho. Digite «PowerShell ISE» na barra de pesquisa e selecione**«Executar como ad­mi­nis­tra­dor**».

Imagem: Inicio del ISE de PowerShell
Ejecuta el ISE de PowerShell como ad­mi­nis­tra­dor

Passo 2. Crie um novo script

No ISE do PowerShell, pode criar um novo script clicando em «Ficheiro» > «Novo» ou uti­li­zando a com­bi­na­ção de teclas [Ctrl] + [N]. Escreva o seu código PowerShell na janela principal do ISE. Terá acesso a fun­ci­o­na­li­da­des como realce de sintaxe, pre­en­chi­mento au­to­má­tico de código e uma interface de uti­li­za­dor intuitiva que facilita o de­sen­vol­vi­mento de scripts.

Eis um exemplo de um script simples:

# This is a comment 
$message = "Hello World!" 
Write-Host $message
powershell

Passo 3. Guarde o script

Clique em «Arquivo» > «Guardar» ou pressione **[Ctrl] + [S]**. Cer­ti­fi­que-se de que adiciona a extensão «.ps1» para guardar o script como um ficheiro PowerShell.

Execute o script do PowerShell

Um script do PowerShell é nor­mal­mente iniciado através da consola do PowerShell ou de outro terminal.

Passo 1. Inicie o PowerShell

Primeiro, abra o PowerShell com direitos de ad­mi­nis­tra­dor, tal como no exemplo do ISE.

Passo 2. Altere a Exe­cu­ti­on­Po­licy

O PowerShell inclui quatro políticas deexecução di­fe­ren­tes que controlam a segurança e a ca­pa­ci­dade de executar scripts no ambiente do PowerShell. As quatro políticas de execução comuns são:

  • Res­tric­ted (Restrita): é a política de execução pre­de­fi­nida para o PowerShell. Com esta política, os scripts estão de­sa­ti­va­dos e apenas é possível executar comandos in­te­ra­ti­vos na consola. Isto pro­por­ci­ona o nível máximo de segurança, uma vez que a execução de scripts está bloqueada por pre­de­fi­ni­ção.
  • AllSigned (Todos assinados): com esta política, todos os scripts devem estar di­gi­tal­mente assinados para poderem ser exe­cu­ta­dos. Isto significa que o autor do script deve utilizar um cer­ti­fi­cado digital para assinar o script.
  • Re­mo­te­Sig­ned (Assinado re­mo­ta­mente): com Re­mo­te­Sig­ned, apenas os scripts pro­ve­ni­en­tes da Internet ou de um local de rede devem estar assinados. Os scripts locais ar­ma­ze­na­dos no seu com­pu­ta­dor podem ser exe­cu­ta­dos sem as­si­na­tura. Isto facilita a uti­li­za­ção de scripts locais.
  • Un­res­tric­ted (Sem res­tri­ções): esta política permite a execução de todos os scripts sem qualquer as­si­na­tura ou restrição. Não é acon­se­lhá­vel utilizar esta política num ambiente de produção, uma vez que re­pre­senta um risco de segurança. Só deve ser con­si­de­rada para fins de teste ou em ambientes seguros.

Pode ver a política de execução atual no seu ambiente do PowerShell uti­li­zando o comando Get-Exe­cu­ti­on­Po­licy. Para alterar a política de execução, utilize o comando Set-Exe­cu­ti­on­Po­licy seguido da política pre­ten­dida.

Pode in­tro­du­zir o seguinte comando para permitir a execução de scripts no PowerShell:

Set-ExecutionPolicy RemoteSigned
powershell
Imagem: PowerShell ISE
Cambiar Exe­cu­ti­on­Po­licy en el ISE de PowerShell

Passo 3. Confirme a execução (se ne­ces­sá­rio)

De­pen­dendo das con­fi­gu­ra­ções de segurança do seu ambiente PowerShell, poderá receber uma mensagem de segurança a pedir que confirme se pretende executar o script. Digite «Y» ou «A» para aceitar, ou «N» para «Não».

Passo 4. Execute o script do PowerShell

Para executar o script do PowerShell, insira o caminho para o ficheiro:

& "C:\PATH\TO\SCRIPT\script.ps1"
powershell
Ir para o menu principal