A manipulação de scripts PowerShell pode revelar-se uma experiência estimulante, já que oferece uma plataforma clara para o desenvolvimento de scripts que automatizam as tarefas do quotidiano.
Se você é um programador, poderá criar scripts de automação sofisticados – o PowerShell destaca-se nesta área, principalmente quando usado para desenvolver, testar e aplicar soluções em ambientes de CI/CD.
Neste artigo, vamos analisar detalhadamente como criar e executar scripts PowerShell. Apresentaremos um guia passo a passo sobre como realizar estas ações com o VS Code, o Bloco de Notas e o Ambiente de Scripting Integrado.
Vamos começar.
O que é o PowerShell?
O PowerShell é uma ferramenta de automação e configuração multiplataforma. Fornece um conjunto completo de utilitários para que administradores, programadores e outros utilizadores possam usar cmdlets (comandos pequenos e simples) para gerir diversas tarefas.
Dentro deste conjunto, você encontra:
Ao contrário do Prompt de Comando, está disponível em todas as plataformas principais, como Windows, Linux e macOS.
Tecnicamente, o PowerShell é construído sobre a estrutura .NET. Graças a esta abordagem, suporta objetos e dados estruturados como JSON, CSV e XML. Os programadores podem também utilizar APIs REST com o PowerShell. O Prompt de Comando básico não oferece suporte para estas funcionalidades, pois é baseado em texto.
Todos os scripts PowerShell são escritos com a extensão .ps1.
Ao criar scripts em PowerShell, você precisa compreender três conceitos principais:
- Cmdlet: São os scripts executáveis básicos que oferecem funcionalidades predefinidas. Por exemplo, você pode usar Copy-Item para copiar, Get-Help para obter assistência ou Write-Host para exibir informações no ecrã.
- Aliases: Os aliases proporcionam uma maneira simples de referenciar cmdlets, oferecendo um acesso mais rápido. No entanto, é aconselhável usá-los em prompts para fins interativos e não ao criar scripts PowerShell.
- Funções: Uma função é um agrupamento de comandos PowerShell. Os utilizadores podem acionar uma função chamando-a.
PowerShell e Scripting
A criação de scripts é um método fundamental para automatizar partes do seu trabalho. Seja você um programador, administrador ou freelancer, a criação de scripts pode simplificar processos de trabalho rotineiros.
Afinal, existem muitas vantagens nos scripts, incluindo:
- Economizar tempo através da automação.
- Portabilidade de conhecimento.
- Manter a consistência entre sistemas.
- Aprimorar as suas competências e empregabilidade.
Você pode criar scripts em PowerShell, Bash, Ruby ou Python.
Em geral, o PowerShell é uma ferramenta excelente para scripting. No entanto, o Windows impede a execução de scripts devido a configurações de segurança, o que pode levar a erros como “a execução de scripts está desativada neste sistema”. Para contornar esta situação, é preciso definir a política de execução correta (abordaremos isto mais adiante neste artigo).
Por que usar o PowerShell para Scripting?
Uma das maiores razões para o PowerShell ser uma ótima opção para scripting é a sua capacidade de funcionar em diferentes plataformas. Ele oferece suporte a Windows, Linux e macOS, algo que o Prompt de Comando padrão do Windows não oferece.
Você pode usar o PowerShell para criar tarefas simples usando os seus construtores de tarefas. Por exemplo, pode usá-lo para reiniciar uma máquina, limpar a cache periodicamente ou até mesmo autenticar sessões.
Além disso, o script PowerShell é principalmente usado para a automação da gestão de sistemas. No entanto, como programador, pode utilizá-lo para testar, criar e aplicar compilações através de um ambiente de CI/CD.
Como os Scripts PowerShell são Criados?
Para criar scripts PowerShell, você precisa de um editor de texto. Um editor de texto básico é suficiente, mas um editor de texto/código moderno tornará o processo muito mais fácil.
Por essa razão, começaremos explicando como criar scripts PowerShell usando o Visual Studio Code (também conhecido como VS Code). Também abordaremos como criar scripts PowerShell no Bloco de Notas e noutros ambientes amigáveis para scripting, como o Ambiente de Scripting Integrado do PowerShell (PowerShell ISE).
#1. Com VS Code
O VS Code é um editor de código multiplataforma, gratuito, robusto e confiável. A Microsoft desenvolve-o, oferecendo uma vantagem adicional com o seu bom suporte ao PowerShell.
Você obtém uma interface clara, pronta para uso, e pode utilizá-la com praticamente qualquer linguagem de programação.
Como o VS Code é um editor de código adequado, ele oferece suporte a extensões. Para aprimorar a experiência de scripting com PowerShell, utilizaremos a extensão do PowerShell.
Instalando o Visual Studio Code
Mas, antes de tudo, você precisa instalar o VS Code.
Para isso, acesse a página de download do Visual Studio Code. Selecione a versão apropriada do VS Code, baseando-se no seu sistema operacional. Como estamos utilizando o Windows 11, escolhemos a versão para Windows.
Após o download, clique duas vezes no instalador e siga as instruções para instalá-lo no seu computador.
Instalando a Extensão PowerShell
Você pode instalar a extensão PowerShell de duas maneiras. Primeiro, crie um novo arquivo com a extensão .ps1.
O VS Code é inteligente o suficiente para reconhecer que você está trabalhando com PowerShell e irá recomendar a instalação da “Extensão PowerShell” da Microsoft.
Clique em “Instalar” para instalá-la. Se preferir, clique em “Mostrar recomendação” para obter mais informações.
Caso o Visual Studio Code não tenha fornecido nenhuma recomendação, você pode procurar o plug-in manualmente.
Clique no símbolo com quatro quadrados (com um quadrado “a voar”) ou pressione Ctrl + Shift + X para abrir a janela de extensão. Procure por “PowerShell da Microsoft” e clique no primeiro resultado. Em seguida, proceda à instalação.
Por fim, o sistema perguntará se você confia nos autores dos arquivos no espaço de trabalho. Clique em “Trust Workspace & Install” para finalizar a instalação.
Criando o Script PowerShell com VS Code
Agora, você pode criar o seu primeiro script PowerShell com o VS Code e suas extensões devidamente instaladas.
Caso ainda não tenha criado um novo arquivo, siga os passos abaixo:
- Abra o VS Code.
- Vá para o menu superior, clique em Arquivo e depois em Novo Arquivo de Texto.
- Agora, salve o arquivo acedendo a Arquivo > Salvar Como.
- Digite o nome do arquivo e certifique-se de adicionar a extensão .ps1.
- Por fim, clique em Salvar Arquivo.
É isso! Agora, você pode criar seu script. Foi adicionado um cmdlet Write-Host com o valor “Este é um script VS Code escrito para etechpt.com”.
Veremos como executar o script mais adiante. Continue lendo!
#2. Com o Bloco de Notas
Criar scripts PowerShell no Bloco de Notas é simples.
Siga os passos abaixo:
1. Abra o Menu Iniciar e procure por Bloco de Notas.
2. Agora, clique com o botão direito e selecione “Executar como administrador”.
3. Escreva o seu script.
4. Para o tutorial, escrevemos: “Este é um script PowerShell criado no Bloco de Notas”.
5. Vá para Arquivo no menu superior e clique em “Salvar Como”.
6. Selecione o nome do script e clique em “Salvar”.
E pronto! Você criou um script PowerShell com o Bloco de Notas.
#3. Com o PowerShell ISE
O PowerShell no Windows também oferece o seu próprio ambiente de scripting integrado. Você pode usá-lo para codificar scripts sem depender de código de terceiros ou editores de texto.
Para utilizá-lo, siga os passos abaixo:
1. Abra o Menu Iniciar.
2. Procure pela palavra-chave “Windows PowerShell ISE”.
3. Selecione o primeiro resultado, clique com o botão direito e clique com o botão esquerdo em “Executar como administrador”. Abrirá a janela do PowerShell ISE.
4. Clique em Arquivo e selecione “Novo”. Irá abrir uma nova janela de arquivo.
7. Digite o script desejado. Para o tutorial, escrevemos: “Este é um script PowerShell escrito com o auxílio do PowerShell ISE”.
8. Depois de concluído, vá para Arquivo e Salvar Como.
9. Selecione o nome do arquivo e clique em Salvar.
Você também pode executar o script diretamente a partir do PowerShell ISE. Para fazer isso, clique no botão EXECUTAR na parte superior do ambiente. Se surgir um erro de segurança, leia abaixo como resolvê-lo.
Como Resolver o Erro de Segurança de Script do PowerShell e Executá-lo
Como mencionado anteriormente, o Windows tem uma política de segurança rigorosa ao executar scripts. Para contorná-la, é preciso ativar a execução de scripts na sua máquina Windows.
Para isso, siga os passos abaixo:
- Abra o Menu Iniciar do Windows.
- Procure por PowerShell.
- Clique com o botão direito no aplicativo PowerShell.
- Selecione a opção “Executar como administrador”.
- Quando o PowerShell abrir, digite o comando “Set-ExecutionPolicy RemoteSigned”.
- Pressione Enter e o sistema solicitará a confirmação. Pressione A para ativar.
Pronto! Agora, você pode executar os seus scripts!
No PowerShell ISE, aparece da seguinte maneira.
No Visual Studio Code, aparece da seguinte maneira.
E, no Bloco de Notas, é necessário executá-lo diretamente no Prompt de Comando do PowerShell.
Melhores Práticas para Escrever e Executar Scripts PowerShell
É fundamental seguir as melhores práticas ao trabalhar com scripts PowerShell. Estas práticas incluem:
- Utilizar o nome completo do cmdlet, em vez de utilizar um alias. O alias é útil somente ao interagir com o console. Um alias melhora a interatividade, mas pode dificultar a leitura do script.
- É melhor não utilizar o cmdlet Write-Host, pois ele oferece funcionalidades limitadas. Por exemplo, ele apenas envia o resultado para o ecrã. No entanto, você pode usá-lo para exibir texto com uma cor específica. Em vez disso, você pode usar o cmdlet Write-Output.
- Utilizar sempre o substantivo singular do cmdlet em vez do substantivo plural.
- Utilizar o verbo correto para o cmdlet.
- Especificar a extensão do aplicativo sempre que possível. Isto evita confusões e melhora a legibilidade.
- Utilizar um editor de código PowerShell dedicado, como o VS Code ou o PowerShell ISE. Eles oferecem excelentes recursos para escrever e executar scripts PowerShell. Você pode usar o Bloco de Notas ou o Notepad++, mas estará a limitar-se.
- Tentar comentar o seu código, mas não exagerar, pois isto pode prejudicar a legibilidade e manutenção do código.
- Certificar-se de que você definiu o parâmetro de segurança correto para executar scripts PowerShell.
Conclusão
Pronto! Agora você já pode criar e executar scripts PowerShell usando o Bloco de Notas, o VS Code e o PowerShell ISE. Além disso, você pode usar qualquer uma das ferramentas mencionadas para escrever e executar scripts PowerShell.
No entanto, como mencionado nas melhores práticas, é melhor evitar usar o Bloco de Notas ou o Notepad++ para escrever scripts PowerShell, pois estará perdendo muitos recursos fornecidos pelos editores de código VS Code e PowerShell ISE.
Em seguida, você também pode consultar como verificar a versão do PowerShell e atualizá-la no servidor Windows.