PowerShell é uma ferramenta de linha de comando desenvolvida pela Microsoft para automatizar tarefas administrativas comuns. Um script é uma coleção de comandos do PowerShell, armazenados em um arquivo de texto, com a extensão de arquivo *.ps1. Ao executar um script do PowerShell, o interpretador lê o arquivo e executa os comandos sequencialmente.
Você pode criar um script do PowerShell usando qualquer editor de texto (até mesmo o NotePad). Mas de preferência, é recomendado usar um editor de scripts do PowerShell. O editor padrão incluído no Windows é o Ambiente de Scripting Integrado do PowerShell (PowerShell ISE). Ele inclui funções úteis como coloração, conclusão de código, verificação de sintaxe, depuração, salvamento automático, proteção contra falhas, etc.
A Microsoft tem um editor de código livre e multiplataforma chamado Visual Studio Code (VS Code), que está disponível para Windows, Linux e macOS. Ele suporta uma variedade de linguagens de programação por meio de extensões que você pode instalar, incluindo o PowerShell.
Uma vantagem do Visual Studio Code é que ele suporta as versões mais recentes do PowerShell, enquanto o PowerShell ISE suporta apenas até a versão 5.1 do PowerShell.
Como executar um script do PowerShell (guia rápido)
Aqui está uma rápida explicação de como executar um script do PowerShell. O método a seguir funciona para scripts do PowerShell que não têm parâmetros obrigatórios e não retornam saída para o prompt de comando.
- Clique com o botão direito do mouse no script do PowerShell no Explorador de Arquivos.
- Selecione Executar com o PowerShell no menu de contexto.
- O script será executado com uma política de execução de Bypass. A política de execução para o computador ou usuário não é alterada.
Para mais detalhes sobre como escrever e executar scripts do PowerShell, continue lendo!
Como criar scripts do PowerShell
Há algumas maneiras de criar scripts do PowerShell:
- Com o editor de código multiplataforma Visual Studio Code
- Com o PowerShell ISE
Criando scripts do PowerShell com o Visual Studio Code
O Visual Studio Code não está disponível por padrão no Windows, então ele precisa ser baixado do site dedicado do Visual Studio. No nosso caso, precisamos baixar a distribuição do Windows, que está disponível para sistemas de 64 bits, 32 bits e ARM.
Aqui estão os diferentes passos que você precisa seguir após instalar o aplicativo. Primeiro, você precisará abrir o Visual Studio Code no menu Iniciar.
Instale a extensão do PowerShell
Abra o menu de extensões clicando no ícone de extensão mostrado na figura abaixo, ou use o atalho de teclado Ctrl + Shift + X.
Digite powershell na caixa de pesquisa, selecione a opção mais baixada como mostrado abaixo, garantindo que você baixe a extensão fornecida pela Microsoft. Em seguida, clique em Instalar.
Quando a instalação estiver concluída, você não verá nenhuma confirmação. No entanto, você verá que o botão Instalar foi substituído pelas opções Desativar e Desinstalar.
Como criar um script do PowerShell com o Visual Studio Code
Para criar um novo script do PowerShell, vá para Arquivo > Novo Arquivo, ou use o atalho de teclado Ctrl + N.
Para especificar que o novo arquivo é um script do PowerShell, clique em Texto Simples no lado inferior esquerdo, ou Selecionar um Idioma no painel de script. Qualquer opção o levará para a caixa de Selecionar um Modo de Idioma. Digite powershell e então selecione PowerShell.
Isso ativará a Extensão PowerShell, e você verá uma mudança no comportamento e funcionalidade. Primeiro, você notará que o ícone ao lado do Nome do Arquivo mudará para PowerShell. Além disso, você notará que o Console do PowerShell será iniciado, e é lá que você poderá executar comandos e scripts do PowerShell.
O mesmo resultado pode ser alcançado salvando o arquivo com a extensão *.ps1.
Digite os seguintes comandos no painel de script e você apreciará benefícios como coloração, auto-completar comando e dicas de sintaxe em ação:
Write-Host "This is a Visual Studio Code script" Write-Host "Writing PowerShell Scripts is fun!"
Nota: A terceira linha é apenas para fins de demonstração, para mostrar a opção de conclusão do comando.
Para salvar o arquivo, você pode usar o menu Arquivo: Arquivo > Salvar. Você também pode usar o atalho do teclado Ctrl + S.
Em seguida, use uma localização de fácil acesso, forneça o nome do arquivo, certifique-se de especificar *.ps1 como a extensão do arquivo e clique em Salvar. Neste exemplo, estou armazenando o arquivo em C:\TEMP\MeuScriptVSCode.ps1.
A execução de scripts no VS Code será abordada mais adiante no artigo.
Criando scripts com o Windows PowerShell ISE
Para iniciar o PowerShell ISE, clique no botão Iniciar (ou no botão Pesquisar) e comece a digitar PowerShell ISE. Você verá o aplicativo nos resultados da pesquisa com diferentes opções de abertura. É sempre aconselhável usar Executar como Administrador para garantir que todos os comandos sejam executados corretamente e não sejam bloqueados.
Então, vamos criar um script no PowerShell ISE. Escreva as seguintes linhas e, novamente, você pode notar recursos úteis como codificação de cores, autocompletar de comandos, dicas de sintaxe, etc.:
Write-Host "This is a PowerShell ISE script" Write-Host "Writing PowerShell Scripts is fun!"
Nota: A terceira linha é apenas para fins de demonstração, para mostrar a opção de preenchimento automático de comando.
Agora vamos salvar a lista de comandos como um script do PowerShell. Para fazer isso, você precisa clicar no ícone do disquete na barra de ferramentas, depois clicar em Arquivo > Salvar no menu Arquivo. Você também pode usar o atalho de teclado Ctrl + S.
Na caixa de diálogo Salvar como, escolha uma pasta, forneça um nome de arquivo, especifique a extensão *.ps1 e clique em Salvar. Neste exemplo, estou fornecendo o seguinte nome: C:\TEMP\MyPowerShellISEScript.ps1.
Criando scripts com o NotePad
Não é recomendado usar um editor de texto básico para escrever scripts do PowerShell, mas é uma possibilidade. Vamos dar um exemplo com o NotePad
- Abra o NotePad e digite os seguintes comandos:
Write-Host "This is a Notepad script" Write-Host "Writing PowerShell Scripts is fun!
- Para salvar o script, selecione Arquivo > Salvar.
- Na caixa de diálogo Salvar como, escolha uma pasta e forneça um nome de arquivo com a extensão *.ps1. Neste exemplo, estou usando: C:\TEMP\MyNotepadScript.ps1.
Como executar scripts do PowerShell
A PowerShell script (*.ps1 file) can be run in the PowerShell console, which recognizes the *.ps1 file type and runs the commands sequentially. You may open the script as a file in code editors like the PowerShell ISE and Visual Studio Code, and run the whole script in the console pane or run only a part of it.
Como habilitar scripts do PowerShell alterando a política de execução
As políticas de execução do PowerShell são um recurso de segurança que controla as condições sob as quais o PowerShell carrega arquivos de configuração e executa scripts. É importante destacar que isso não é um sistema de segurança, pois as políticas de execução podem ser facilmente contornadas. No entanto, elas ajudam a proteger os usuários de executar scripts involuntariamente.
A política de execução padrão para o Windows 11 é Restrito. Em sistemas operacionais não Windows, a política de execução padrão é Ilimitado, e não pode ser alterada.
Para visualizar a política de execução atual, use o comando do PowerShell Get-ExecutionPolicy.
Você pode alterar a política de execução no Windows usando o cmdlet Set-ExecutionPolicy:
Set-ExecutionPolicy -ExecutionPolicy <PolicyName>
As diferentes políticas de execução serão discutidas no próximo tópico.
Alterando a política de execução do PowerShell
No Windows, você pode definir a política de execução para a máquina local, o usuário atual ou o processo do PowerShell.
Para listar todos os escopos disponíveis, use Get-ExecutionPolicy -List.
Get-ExecutionPolicy -List
A ordem é importante, portanto, o item configurado mais alto tem precedência. Por exemplo, se você definiu uma política de execução usando uma política de grupo, ela terá precedência sobre os outros.
| Policy | Description |
| Restricted | The default execution policy for Windows client OSes. It does not allow ANY scripts (*.ps1 files) to be executed. Still, you may run individual commands. |
| RemoteSigned | The default execution policy for Windows Server. It Allows running scripts that are created locally. Scripts downloaded from untrusted locations, like the Internet, e-mail, messengers, etc. must be digitally signed by a trusted publisher. You may use the command Unblock-File to allow a script to run on the system. |
| Unrestricted | The default execution policy for non-Windows computers, and it cannot be changed. It allows unsigned scripts to run, but it shows a warning message and asks for confirmation if scripts are coming from an untrusted location. |
| AllSigned | It requires all scripts running on the machine to be digitally signed by a trusted publisher, no matter if they are created locally on the machine or downloaded from the Internet. |
| Bypass | It allows all scripts to run, like Unrestricted, but no confirmation is required. |
| Undefined | There is no execution policy set on the specified scope. If all scopes are set as undefined, then the default execution policies are applied. |
Para permitir que o PowerShell execute scripts, você precisa usar o comando Set-ExecutionPolicy -ExecutionPolicy <PolicyName>.
Set-ExecutionPolicy -ExecutionPolicy <PolicyName>
Por padrão, este comando aplica sua política escolhida ao escopo Máquina local. Se você deseja especificar um escopo diferente, deve usar o parâmetro -Scope e fornecer o nome do escopo.
Por exemplo, o seguinte comando define a política de execução como Ilimitada para o usuário atual:
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
Executando um script com o PowerShell
Para abrir o console do PowerShell, clique no botão Iniciar (ou no botão de pesquisa), digite powershell e clique em Executar como Administrador.
Para executar um script no console do PowerShell, você pode:
- Usar o caminho completo para o script, como: C:\TEMP\MyNotepadScript.ps1
- Ou usar apenas o nome do script, a partir da pasta onde o arquivo está localizado: .\MyNotepadScript.ps1
Executando um script do PowerShell no Visual Studio Code
Para executar um script no Visual Studio Code, você precisa iniciar o aplicativo e abrir o arquivo de script criado anteriormente (C:\TEMP\MyVSCodeScript.ps1).
- Selecione Arquivo > Abrir Arquivo ou use o atalho de teclado Ctrl + O.
- Com o script carregado no VS Code, você pode executá-lo clicando no botão Executar no canto superior direito, ou pressionando F5 no seu teclado.
O script será executado na janela do console, onde você verá a saída do script.
Outra opção seria executar apenas uma parte do script (Executar Seleção). Isso é frequentemente útil quando você está criando seu script e gostaria de confirmar que partes dele se comportam conforme o esperado.
- Para executar uma seleção do script, destaque a parte que deseja executar.
- Clique em Executar Seleção no canto superior direito do console, ou pressione F8 no seu teclado.
Desta vez, o VS Code executa apenas as linhas de código selecionadas na janela do console.
Executando um script no PowerShell ISE
Executar scripts no PowerShell ISE é bastante similar.
- Inicie o PowerShell ISE.
- Abra o script da demonstração anterior (neste caso – C:\TEMP\MyPowerShellISEScript.ps1) usando Arquivo > Abrir, ou o Abrir ícone da barra de ferramentas, ou o atalho de teclado Ctrl + O.
- Selecione o arquivo do script e clique em Abrir.
Para executar todo o script, use o botão Executar na barra de ferramentas ou pressione F5 no seu teclado. Isso executará o arquivo de script na janela do console, retornando o resultado.
Se você precisar executar apenas parte do script, destaque a seção e selecione Executar Seleção na barra de ferramentas ou pressione F8 no seu teclado. Novamente, o PowerShell ISE executará apenas as linhas de código selecionadas.
Executando um script do PowerShell no Prompt de Comando
Se os arquivos *.ps1 forem interpretados pelo PowerShell, o Prompt de Comando (CMD) não poderá trabalhar diretamente com scripts do PowerShell. Se você deseja executar um script do PowerShell no CMD, precisará executá-lo chamando o processo do PowerShell com o parâmetro -File, como mostrado abaixo:
PowerShell -File C:\TEMP\MyNotepadScript.ps1.
Conclusão
Os scripts do PowerShell são uma ótima maneira de automatizar tarefas repetitivas. Siga a regra geral: “Se você precisa fazer algo mais de uma vez, monte um script”, e você não terá erros!
Artigo relacionado:
Source:
https://petri.com/how-to-write-and-run-a-powershell-script-file-on-windows-11/