Se você é novo na linguagem de script PowerShell e deseja aprender como executar scripts no PowerShell, você veio para o post certo. Este blog será um tutorial cobrindo maneiras comuns de executar scripts e alguns problemas que podem surgir.
Pré-requisitos
Este artigo será um guia para você sobre como executar o PowerShell em seu computador local. Se deseja seguir junto, certifique-se de ter os seguintes pré-requisitos em vigor antes de começar este artigo.
- A Windows 10 computer with Administrator privileges.
- Windows PowerShell versão 5 ou superior. Você também pode usar PowerShell v7. Este tutorial se concentrará no Windows PowerShell, já que o sistema operacional Windows já o possui.
- Qualquer editor de arquivo de texto
Lidando com a Política de Execução
Se esta é a primeira vez que você está tentando executar um script do Windows PowerShell, você pode encontrar um problema comum. O PowerShell provavelmente retornará uma mensagem de erro informando que um script “não pode ser carregado porque a execução de scripts está desativada neste sistema”.
O PowerShell retorna a mensagem de erro acima quando você tenta executar um script PowerShell com uma política de execução definida como Restrita, Assinada Remotamente ou Todas as Assinadas.
Restrita
é a política padrão definida para computadores cliente Windows. Se você estiver usando o PowerShell pela primeira vez, sua política padrão provavelmente estará configurada para restringir todos os scripts.
Você ainda pode executar comandos individuais no terminal, mas não um arquivo de script. A restrição inclui qualquer arquivo com terminação .ps1xml, .psm1 ou .ps1.
Não Restrita
Não restrita permite que você execute qualquer script, no entanto, avisa antes da execução se o script for baixado da internet. Essa política é geralmente a padrão para dispositivos não-Windows.
Assinada Remotamente
A política Assinada Remotamente permite que você execute qualquer script que esteja (a) assinado digitalmente ou (b) qualquer script escrito em seu computador local, com ou sem uma assinatura.
Se um script for baixado da internet e não estiver assinado, será necessário desbloquear o arquivo. Você pode fazer isso clicando com o botão direito no arquivo e escolhendo Propriedades. Ou, você pode usar o cmdlet PowerShell Unblock-File para aquele arquivo de script específico.
Usar uma política Assinada Remotamente seria uma opção ideal ao executar um script baixado da internet.
Todas as Assinadas
Todas as assinadas exigem que todos os scripts sejam assinados digitalmente por um editor confiável. Isso inclui os scripts baixados da internet e escritos localmente em seu computador.
Mudando a Política de Execução do PowerShell
Para alterar a política de execução:
- Abra o Windows PowerShell com a opção Executar como Administrador para garantir que você tenha as permissões mais altas para realizar as alterações de política.
2. Quando aberto, execute o seguinte comando PowerShell para definir a política de execução do seu computador. A política de execução, como mencionado anteriormente, pode ser um dos três tipos diferentes. Este tutorial está utilizando uma política de execução útil, porém ainda segura, chamada RemoteSigned.
Dado que este tutorial assume que você baixou da Internet o arquivo de script GetServices.ps1, defina a política de execução como RemoteSigned.
A política de execução RemoteSigned obriga você a assinar criptograficamente cada script do PowerShell baixado da Internet antes que o PowerShell o execute em seu sistema.
3. Você verá uma saída solicitando a confirmação da ação. Digite Y e pressione Enter para confirmar a alteração da política.
Neste ponto, siga os próximos passos para explorar métodos diferentes para executar o script do PowerShell em seu computador.
Como Executar um Script do PowerShell
Para demonstrar a execução de um script do PowerShell, você realmente precisa de um arquivo de script para executar! Se você não tiver um à mão, baixe este arquivo ZIP e extraia o arquivo PS1 de dentro. Você encontrará um arquivo de script simples chamado GetServices.ps1.
Todo script do PowerShell deve ter a extensão
.ps1.
Usando o Console
Depois de ter um script pronto, existem algumas maneiras diferentes de executar um arquivo de script do PowerShell. Uma das maneiras mais comuns é via console do PowerShell.
Para fazer isso:
- Abra o console do PowerShell conforme mostrado acima.
2. Navegue até o local do sistema de arquivos onde seu script está localizado usando o cmdlet Set-Location do PowerShell ou o alias cd. O script deste tutorial está no diretório C:\Temp.
3. Execute o script usando a notação de ponto (.). O PowerShell é um shell que também procura por nomes de comandos. Para diferenciar entre um comando do PowerShell e um script, você deve prefixar o script com um ponto. Este ponto representa o diretório atual.
Como Executar um Script do PowerShell pela Linha de Comando via Localização do PowerShell
Se você não pode ou prefere não executar scripts via console do PowerShell, você também pode fazer isso pela boa e velha linha de comando (prompt de comando).
Para executar scripts via prompt de comando, você deve primeiro iniciar o executável do PowerShell (powershell.exe), com a localização do PowerShell em C:\Program Files\WindowsPowerShell\powershell.exe e então passar o caminho do script como parâmetro para ele.
Você pode executar scripts com parâmetros em qualquer contexto simplesmente especificando-os ao executar o executável do PowerShell como
powershell.exe -Parâmetro 'Foo' -Parâmetro2 'Bar'.
Ao abrir cmd.exe, você pode executar um script do PowerShell como abaixo. Este exemplo está executando o motor e passando o caminho do script como C:\Temp\GetServices.ps1.
Observe abaixo que o exemplo está utilizando o caminho da localização do PowerShell para executar o script. Você terá que fazer isso se a pasta não estiver em seu PATH em algum lugar.
A localização do PowerShell para o PowerShell 7 usa um executável diferente chamado pwsh.exe, geralmente localizado em C:\Program Files\PowerShell\7\pwsh.exe.
Abaixo está um vídeo útil do YouTube que aborda a execução de um script via um arquivo em lote que o cmd.exe executa.
Usando o PowerShell ISE
Se você criar seus próprios scripts ou editar os de outros, provavelmente estará usando um editor de script como o PowerShell ISE ou talvez o Visual Studio (VS) Code. Como o ISE vem com o Windows, vamos nos concentrar nesse método para este tutorial.
Para invocar um script via ISE:
- Vá para o Menu Iniciar, procure por PowerShell ISE e abra-o.
2. Clique em Arquivo → Abrir e encontre o seu script.
3. Com o script aberto, clique no botão verde de execução para executar o script. Este botão irá invocar o script no terminal integrado do PowerShell na parte inferior.
A Saída do Script de Exemplo
A PowerShell script can sometimes return output. This happens when the script you’re executing is built to return objects which is a fundamental component of PowerShell.
Se você executar o script de exemplo GetServices.ps1, verá o seguinte. Este script executa o cmdlet Get-Service, que retorna todos os serviços instalados no seu computador Windows local.
Executando um Script do PowerShell de Dentro de Outro Script
Vamos supor que você tenha dois scripts e queira que um chame o outro. Talvez você tenha um script chamado GetUser.ps1 e outro chamado ResetPassword.ps1. Dentro do script GetUser.ps1, você gostaria de executar o ResetPassword.ps1 para redefinir a senha de um usuário.
Dentro do script chamador (GetUser.ps1), você adicionaria uma linha para executar o outro script, assim como faria ao chamar o script a partir da linha de comando.
Você pode ver abaixo que tem algumas opções. Normalmente, você deve escolher executar o outro script na mesma sessão ou escopo para simplificar as coisas, a menos que tenha um motivo específico para executar o script em outra sessão do PowerShell.