DEV Community: Microsoft Learn Student Ambassadors Latam

Powershell + BATs

Ivo Dias — Fri, 12 Feb 2021 17:04:27 +0000

O uso de um script Powershell pode não ser muito pratico para alguns usuários, ao contrario de uma BAT (arquivo de lotes do Windows), que pode ser iniciada clicando.

Para contextualizar, eu trabalhei em alguns locais que dentro da equipe de suporte eu era um dos poucos que tinha uma intimidade maior com a linha de comando, e para não limitar o uso das automações, tomamos como padrão que elas seriam iniciadas por BATs.
Assim, mesmo alguém do administrativo poderia utilizar algumas automações de forma simples, apenas clicando nelas.

Mas o processo de ficar escrevendo uma BAT para cada programa era algo um pouco chato, então cheguei num modelo e criei uma função para automatizar a criação das BATs.

Como exemplo, vou utilizar a que cria BATs dentro de um processo de automação de instalações.
Para utilizar ela, vamos precisa de algumas informações:

O nome do programa que vamos instalar
O caminho para o PS1 com a automação da instalação
A versão do projeto
O caminho onde queremos salvar a BAT

Certo, mas como vamos escrever essa BAT?
Basicamente, temos um texto base do script com alguns pontos chaves. Salvamos ele dentro de uma variável, como uma string qualquer, e alteramos os valores utilizando variáveis.
No fim, criamos um arquivo com esse conteúdo e com a extensão BAT.

Nosso código vai ficar um pouco bagunçado, já que não conseguimos indentar corretamente nosso código para manter a formatação da BAT, mas ele fica assim:

Esse projeto pode parecer meio maluco, mas na verdade ele faz parte de um ainda mais. Explicando um pouco, teve um cenário onde fazia muito sentido ter um executável para instalar programas de forma silenciosa, mas qual a forma mais fácil de fazer isso?

Na minha visão na época, escrever um script em Powershell que escreveria:

Um script Powershell de instalação
Uma BAT para executar esse script
Um script em GO para iniciar a BAT

Depois de escrever cada um deles, faz a compilação do executável em GO e com isso permite o uso do EXE como queríamos.

Provavelmente existem formas melhores de se fazer isso, já que reconheço a enorme gambiarra, mas sem dúvidas foi um projeto bem divertido.

Caso queira ler, publiquei no meu GITHUB.

Automatizando a instalação de software

Ivo Dias — Thu, 11 Feb 2021 18:27:58 +0000

O processo de instalação de software no Windows tende ser algo muito simples, normalmente apenas ficar clicando em próximo até que se complete, mas será que temos uma forma de automatizar isso?

A resposta é sim, seja para instalar de forma silenciosa como vamos debater aqui ou clicando nas opções, o que podemos conversar mais tarde sobre, só que utilizando Python.

O processo de instalação silencioso depende muito do fabricante do instalador, já que é ele quem vai adicionar ou não o suporte, e principalmente a qualidade das informações e utilização.

Caso o instalador seja um .MSI o processo vai ser bem mais simples, já que esse pacote é feito para facilitar esse processo, mas podemos também fazer com executáveis. Recomendo que para o que planeja utilizar, busque com o fabricante quais as opções necessárias.

Como queremos escrever um script genérico de instalação, vamos abstrair um pouco esse processo. O processo basicamente, é verificar se o programa já existe, caso não, pegamos nosso instalador e executamos ele.

Mas quais as informações que precisamos para fazer isso?
Para organização, o nome do Software é muito importante.
O caminho e nome do instalador também é algo bem importante, resolvi separar os dois, para o caso onde tenha uma pasta padrão de instaladores.
Os parâmetros são a parte mais chata, já que eles variam conforme o fabricante.
Por fim, para sabermos se o program já está instalado, vamos validar pela pasta onde normalmente fica instalado (sim, não é a melhor forma, mas no começo já é algo).

Tendo todas as informações, vamos ao processo:

Copiar o instalador para uma pasta local
Executar o instalador com o parâmetro
Validar se o processo foi concluído ou não

Traduzindo para Powershell, temos:

Como esse processo pode ser um pouco abstrato, vou deixar de exemplo como seria a instalação do Adobe Reader

Alguns pontos de melhoria relevantes que podem ficar de lição de casa:

Fazer o download do instalador do site do fabricante em vez de uma pasta num servidor
Validar de uma forma mais precisa se o programa está instalado
Adicionar LOGs na instalação, como verificar o tempo decorrido

WSL: Instalando Linux no Windows

Ivo Dias — Wed, 10 Feb 2021 12:15:09 +0000

Seguindo a linha de quem melhor pode explicar sobre algo é seu criador, vamos definir WSL como:

"O Subsistema do Windows para Linux permite que os desenvolvedores executem um ambiente GNU/Linux, incluindo a maioria das ferramentas de linha de comando, utilitários e aplicativos, diretamente no Windows, sem modificações e sem a sobrecarga de uma máquina virtual tradicional ou instalação dualboot."

Essa explicação e mais detalhes estão disponíveis na documentação oficial, que como sempre recomendo a leitura.

Nesse artigo, não vamos entrar muito no mérito de como utilizar ou o que exatamente é ele, e sim em como podemos fazer a instalação de forma automatizada pelo Powershell.

Eu escrevi esse script para uma aula de Sistemas Operacionais da Fatec, como um tutorial de instalação do Ubuntu já que não queria utilizar uma maquina virtual e me parecia interessante mostrar que dentro do Windows 10 podemos fazer coisas bem legais.

Inicialmente, vamos verificar se já temos o WSL disponível no sistema. Caso ela não esteja, fazemos a instalação e orientamos que o usuário reinicie o computador para que ela fiquei totalmente habilitada.

Depois disso, vamos fazer o download do sistema operacional, que em nosso exemplo vai ser o Ubuntu 1604. Salvamos o artefato como um APPX conforme está disponível no site da Microsoft.

Concluído o download, fazemos a instalação e apagamos o arquivo.

Assim deixamos disponível um terminal Linux para utilização dentro do Windows 10.

Recomendo isso caso precise treinar comandos ou brincar um pouco com o sistema. No caso da aula, serviu ao proposito de treinar alguns comandos.

Importando módulos

Ivo Dias — Tue, 09 Feb 2021 17:12:50 +0000

Para começar, é importante entendermos o que são módulos.
Para facilitar, de uma maneira bem simplificada, módulos são um conjunto de funções, normalmente "temáticos", como exemplo temos o modulo de gerenciamento do Azure, com diversas funções relacionados ao gerenciamento de recursos nele.

Para saber mais sobre módulos, recomendo verificar a documentação oficial.

A ideia desse artigo, é mostrar uma forma de automatizarmos o processo de importação e/ou instalação de um, por meio de uma função que vai validar se ele já está disponível para importar ou se precisa instalar antes disso.

Para sabermos se ele já está disponível, vamos consultar o nome dele na lista de módulos disponíveis no equipamento. Caso ele esteja, fazemos apenas o processo de importação, mas caso não, primeiro instalamos e depois importamos.

Powershell + Alexa, iniciando o dia

Ivo Dias — Mon, 08 Feb 2021 12:12:26 +0000

A ideia desse script veio com uma automação que eu fiz em casa utilizando a Alexa (sim, eu usei Powershell junto com ela, preciso dar uma parada com Powershell? Provável), onde a ideia era pedir para ela abrir alguns programas.

Sendo mais especifico, minha ideia era falar "Alexa, hora de trabalhar" e ela abrir todos os programas que eu utilizo normalmente, como o Edge e o Teams.

Para fazer ela funcionar junto com o Powershell, eu usei de base um video, de um canal focado em conteúdos com Alexa:

Basicamente, eu escrevo um script e passo o caminho dele de parâmetro para o Trigger, com isso, ao criar a rotina com a Alexa ela executa tudo que está no meu script.

Pode colocar o que fazer sentido para você, como por exemplo, criar uma rotina para abrir paginas Web, desligar o monitor, mandar um e-mail... um amigo chegou a fazer a Alexa executar pull requests.

Nesse exemplo vamos fazer algo bem simples, meu script inicial para abrir o navegador e o chat da empresa. No navegador, coloquei para abrir o Email corporativo, no caso o site do Outlook para empresas/estudantes.

No inicio, ele verifica se esses programas já estão abertos, ou seja, ele não vai tentar abrir eles se já estão abertos. Você pode criar um segundo script, e configurar um para encerrar os programas relacionados ao trabalho.

No lado da rotina da Alexa, coloquei para ligar a luz, ler as noticias do dia e falar minha agenda.

Um detalhe importante, é que esse processo de iniciar cada aplicativo vai ser algo um pouco mais chato, uma vez que precisa ver como pode fazer isso, para cada um dos que pretende utilizar.

Mas no geral, tende a funcionar colocar o caminho do executável dele. Caso seja algo do sistema, provavelmente vai suportar mais parâmetros.

Facilitando o monitoramento de conexão

Ivo Dias — Fri, 05 Feb 2021 12:35:47 +0000

Seguindo a ideia apresentado no nosso artigo de monitoramento com ping, vamos criar uma função para alterar a cor do terminal quando o equipamento estiver online novamente.

Enquanto ele está offline, deixaremos vermelho, e quando ficar online, ficara verde.

Vamos basicamente colocar um teste de conexão dentro de um loop de repetição para validar cada um dos cenários. Para representar as cores, vamos escrever na tela uma barra feita de vários espaços (Exemplo: " "), alterando a cor de fundo delas.

Assim que o equipamento responder na rede, mostramos a barra verde e encerramos o loop.

Para a validação do equipamento, vamos usar a função Test-Connection.

Como retorno, teremos isso no terminal:

Monitorando com Ping

Ivo Dias — Thu, 04 Feb 2021 13:29:02 +0000

Em alguns momentos pode ser necessário verificarmos quando um equipamento está online na rede, como quando reiniciamos remotamente e queremos saber quando poderemos acessar novamente.
Para isso pode ser interessante manter um LOG, ou um registro, dessa validação.

A ideia do script de hoje, é escrever uma função para ficar com um Ping constante para um determinado computador ou seja, ficar continuamente enviando pacotes e analisando esse processo. Mas além disso, vamos registrar num arquivo de texto todo esse processo.

Fora o Ping em si, que recomendo a leitura desse artigo, vamos utilizar uma nova função dentro do Powershell, para salvar tudo que vemos em nossa tela, chamada Start-Transcript. Também vamos alterar o titulo do nosso terminar.

Deixamos no titulo a orientação sobre como encerrar essa função, por meio dos comandos CTRL + C.

O uso dessa função é muito interessante no cenário que comentei de reiniciar um equipamento remotamente e monitorar quando ele fica online. Com base nele, pode trabalhar em outras coisas como analisar o retorno do comando e mudar a cor do terminal quando o equipamento estiver online novamente.

Pesquisando termos dentro de um texto

Ivo Dias — Wed, 03 Feb 2021 16:18:45 +0000

O que podemos fazer quando temos uma pasta cheia de textos e queremos saber se neles tem um determinado termo?
Abrir todos eles e ver um a um!!

Ok, pode não ser eficiente fazer isso manualmente, mas e se escrevermos uma função para fazer isso?

Podemos deixar o computador fazer essa validação e nos retornar onde e em qual arquivo encontrou ele.

Para fazer isso vamos utilizar a função Select-String, com ela podemos localizar textos, passando como parâmetro o arquivo que vamos verificar e o que queremos encontrar.

Como esse retorno pode ficar confuso no terminal, vamos gerar um arquivo na mesma pasta, colocando nele a correlação que encontramos.

Com algumas modificações, podemos utilizar essa mesma função para analisar LOGs e encontrar erros.

Interface gráfica com Powershell

Ivo Dias — Tue, 02 Feb 2021 18:41:05 +0000

Já criamos scripts de backup simples, com funções, com uma forma de acessibilidade, mas será que conseguimos também sair do terminal e deixar ele com uma cara mais de "programa"?

Com o Powershell podemos criar uma interface gráfica simples, e inegavelmente com uma cara antiga, para os scripts.
É um processo bem trabalhoso mas pode ser útil, então vale a pena compartilhar.

Vou tentar pelo texto explicar um pouco da ideia geral do que vamos fazer e compartilhar um script super comentado para exemplificar.

Precisamos ter algumas noção para criar essa interface, a primeira delas é que criaremos um formulário, então vamos pensar que temos uma folha em branco onde precisamos desenhar o que queremos mostrar.

Para esse exemplo, precisamos desenhar:

Campos de texto não interativos
Botões que estão sempre visíveis
Um botão que só vai aparecer quando uma condição for cumprida

Para localizar as pastas, vamos escrever uma função para exibir para o usuário o Windows Explorer e permitir que ele visualmente selecione a pasta que quer salvar e onde quer salvar.

Para fazer a magica acontecer, vamos interagir com um evento do botão, nesse caso o momento em que o usuário clica nele. Trabalhando com esse evento, deixamos de gatilho para que o trecho do código seja executado somente quando o usuário utilizar.

Esse script é realmente mais complicado de explicar, mas com o exemplo, acredito que consiga replicar e modificar.

Precisamos apontar exatamente a posição do que queremos desenhar, o que pode dificultar um pouco o processo de deixar a interface bonita e com uma boa usabilidade.
Um outro ponto de atenção importante, se encerrar o terminal a interface também é fechada.

Concluindo, acho valido comentar que não é só porque conseguimos fazer, que devemos fazer. Powershell é uma linguagem muito útil para automatizar sistemas, mas nem por isso precisamos fazer tudo com ela.
Uma interface gráfica feita por uma linguagem de programação mais "convencional", provavelmente terá um desempenho, usabilidade e aparência melhores do que vamos conseguir nesse script.
E claro, podemos manter nossa logia de manipulação de sistema feita por scripts e aciona-los nessa interface.

Tornando nossas mensagens mais inclusivas

Ivo Dias — Mon, 01 Feb 2021 12:40:05 +0000

Seguindo nosso post anterior sobre como fazer o terminal falar, vamos melhorar nosso código para evitar a repetição de sempre colocar um Write-Host e o narrador com o mesmo texto.

Para resolver isso, vamos criar uma pequena função.
Nela vamos receber o texto da mensagem, escrever ela na tela e utilizar o narrador para falar.

Isso em código, fica assim:

Para exemplificar o uso pratico disso, vamos aplicar ao MyGIT a versão atualizada dos retornos, ficando assim:

Pronto, agora podemos deixar nosso script organizado e com os recursos de fala.

Ensinando o terminal a falar

Ivo Dias — Fri, 29 Jan 2021 12:58:28 +0000

Dessa vez vamos fazer uma coisa um pouco mais divertida, utilizar o Powershell para sintetizar voz ou seja, vamos fazer nosso script falar.

Conseguimos fazer isso utilizando um recurso do sistema, então é importante lembrar que a qualidade da pronuncia vai depender da linguagem instalada no sistema. Exemplo, eu estou usando meu Windows em ingles e passando texto em português para ele ler, o que deixa tudo bem engraçado devido a pronuncia.

Existem alguns usos interessantes para esse recurso, como deixar os retornos dos nossos scripts mais acessíveis, ao não depender unicamente de ler uma tela para saber o que aconteceu.
Um outro que já utilizei, é usar isso em conjunto com formas de se comunicar com outros computadores, criando uma espécie de "radio", podemos trabalhar nessa ideia no futuro.

Inicialmente, vamos trabalhar no script base para o recurso:

Com esse script, pode passar como parâmetro uma mensagem para que o terminal leia. Mas vamos tentar colocar isso num cenário mais pratico, utilizando ele para uma resposta em um script nosso.

Vamos basicamente pegar nosso script que simula a configuração de um repositório GIT local e vamos adicionar aos retornos escritos, o narrador.

Com isso, tornamos nosso script mais inclusivo e divertido.
Eu só não gostei muito da repetição de código com os textos, mas vamos cuidar disso na próxima postagem.

Fazendo download de arquivos

Ivo Dias — Thu, 28 Jan 2021 14:05:31 +0000

Em alguns momentos, pode ser preciso que nosso script faça o download de algum componente ou arquivo, como um executável atualizado.
Mas será que podemos fazer isso com Powershell?

Sim, conseguimos fazer, e pode ser uma solução bem interessante para manter um script de instalação sempre atualizado. Claro que dependemos que a URL esteja atualizada, mas é interessante sabermos como fazer isso.

Para exemplificar, vamos pegar um ZIP do repositório que mantenho os exemplos que uso nos textos publicados nesse blog e depois vamos descompactar os arquivos. Nesse exemplo vamos simular um pouco do processo que uma ferramenta GIT faria para receber o ambiente e tornar ele disponível localmente.

Para fazermos o download, utilizaremos a função Invoke-WebRequest, informando a URL e o arquivo de saída que queremos.

Para deixar mais organizado, seguindo com essa ideia de simular uma ferramenta de GIT, vamos:

Criar uma pasta na raiz do sistema chamada MyGIT
Fazer o download no APP data
Descompactar os arquivos na pasta que criamos
Limpar nosso download

Para fazermos o processo de descompactar, utilizaremos a função Expand-Archive, passando como parâmetro o local do arquivo e onde queremos deixar o arquivo descompactado.

Como isso fica em código?

Com isso podemos de forma funcional simular esse comportamento de fazer o download das pastas e organizar os arquivos. Claro que não é o único uso, como exemplo vou deixar um script que escrevi para o download e configuração de uma ferramenta:

Com isso podemos tornar nossos scripts mais independentes e minimizando a necessidade de manutenção. Caso tenhamos uma URL sempre atualizada pelo fornecedor, o script não vai precisar de nenhuma alteração para continuar funcionando.