Carregando
0xB0Lição 12 de 25

Scripts e módulos

Salve o código como scripts .ps1 com parâmetros, compartilhe funções por ponto-sourcing e módulos e instale módulos da galeria.

26 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Escreva e execute scripts .ps1 com seu próprio bloco param() e entenda a política de execução
  • Reutilize funções por meio de dot-sourcing e construindo um módulo .psm1
  • Encontre e instale módulos da Galeria do PowerShell e personalize seu $PROFILE

Um script é um arquivo .ps1. Execute-o pelo caminho: .\Get-Report.ps1 (ou ./Get-Report.ps1). O .\ é importante - o PowerShell nunca executa scripts da pasta atual pelo nome simples, portanto, um ls.ps1 malicioso não pode sequestrar ls.

Um script pode começar com seu próprio bloco param(), exatamente como uma função, e então receber os parâmetros: .\Get-Report.ps1 -Enclosure volcano -Days 7. Dentro, $PSScriptRoot é a pasta em que o script reside - use-a para localizar arquivos próximos ao script.

scripts.ps1
1$folder = Join-Path ([IO.Path]::GetTempPath()) "scripts-$(Get-Random)"
2New-Item -ItemType Directory -Path $folder | Out-Null
3Set-Content -Path (Join-Path $folder 'Get-Welcome.ps1') -Value @'
4param(
5  [Parameter(Mandatory)][string]$Name,
6  [int]$Times = 1
7)
8foreach ($i in 1..$Times) { "Welcome, $Name!" }
9'@
10& (Join-Path $folder 'Get-Welcome.ps1') -Name 'Skyla' -Times 2
11$script = Join-Path $folder 'Get-Welcome.ps1'
12& $script 'Pebble'
Saída
Welcome, Skyla!
Welcome, Skyla!
Welcome, Pebble!

O & é o operador de chamada: ele executa um comando cujo nome ou caminho está em uma string ou variável. Você precisará dele sempre que o caminho for calculado ou contiver espaços - & "C:\Dragon Tools\report.ps1".

Funções de compartilhamento: dot-sourcing e módulos

A execução de um script normalmente dá a ele seu próprio escopo: quando ele termina, suas variáveis e funções desaparecem. Duas maneiras de mantê-los:

  • Dot-sourcing: . .\helpers.ps1 (um ponto, um espaço e depois o caminho) executa o arquivo no seu escopo, para que suas funções permaneçam definidas. Rápido, mas tudo o que ele define vaza.
  • Módulos: um arquivo .psm1 de funções. Import-Module .\Dragons.psm1 carrega e Export-ModuleMember escolhe quais funções são públicas - os ajudantes permanecem privados. Coloque uma pasta de módulo em um dos caminhos em $env:PSModulePath e ele carrega automaticamente na primeira vez que você chama um de seus comandos.
module.ps1
1$folder = Join-Path ([IO.Path]::GetTempPath()) "module-$(Get-Random)"
2New-Item -ItemType Directory -Path $folder | Out-Null
3$modulePath = Join-Path $folder 'Dragons.psm1'
4Set-Content -Path $modulePath -Value @'
5function Get-Roar { param([string]$Name) "$Name says $(Get-RoarSound)" }
6function Get-RoarSound { 'RAAAWR' }
7Export-ModuleMember -Function Get-Roar
8'@
9Import-Module $modulePath
10Get-Roar -Name 'Ember'
11[bool](Get-Command Get-Roar -ErrorAction SilentlyContinue)
12[bool](Get-Command Get-RoarSound -ErrorAction SilentlyContinue)
13(Get-Module Dragons).ExportedFunctions.Keys -join ','
14Remove-Module Dragons
Saída
Ember says RAAAWR
True
False
Get-Roar

A função pública do módulo ainda pode chamar seu auxiliar privado, mas você não. Isso é encapsulamento.

Milhares de módulos prontos estão na Galeria PowerShell (powershellgallery.com): Find-Module *azure* pesquisa e Install-Module Pester -Scope CurrentUser instala um só para você. (O PowerShell 7.4 adiciona o Install-PSResource mais rápido.) Escolhas populares: Pester para testes, PSScriptAnalyzer para linting, Az para Azure e Microsoft.Graph para Microsoft 365.

Por fim, seu perfil - o script em $PROFILE - é executado sempre que o PowerShell é iniciado. É o lugar para seus aliases, funções e ajustes imediatos favoritos. notepad $PROFILE (ou code $PROFILE) abre; crie-o primeiro com New-Item -Force $PROFILE se não existir.

Principais conclusões

  • Execute scripts por caminho (.\script.ps1); dê a eles um bloco param(); use $PSScriptRoot para arquivos próximos.

  • O operador de chamada & executa um comando ou script cujo caminho está em uma variável.

  • Dot-source (. .\file.ps1) para carregar funções em seu escopo; construa um módulo .psm1 para compartilhá-los corretamente.

  • Install-Module obtém módulos da Galeria do PowerShell; $PROFILE personaliza cada sessão.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: escreva código em scripts PowerShell

Escreva um script no editor e execute-o de verdade com entradas de exemplo, que chegam ao script como $input. Os scripts rodam no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então estes exercícios evitam sintaxe exclusiva do PowerShell 7; seu script e a entrada de teste são enviados para lá.

Exercício 1

Um script com parâmetros

+25 XP

Conclua o arquivo de script que o starter escreve, Get-Enclosure.ps1, para que ele tenha um bloco param() com um -Name obrigatório e um -Size que deve ser small, medium ou large (padrão medium) e saídas Ember needs a medium enclosure.

Então, para cada linha de entrada (Name ou Name Size), chame o script com o operador de chamada &, passando -Size somente quando a linha tiver um.

  • Três dragões
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Exercício 2

Construir um módulo

+25 XP

Escreva um módulo Keepers.psm1 (o starter salva em uma pasta temporária) contendo duas funções:

  • Get-ShiftKeeper -Hour <int> retorna Ada para as horas 6-13, Grace para 14-21 e Linus caso contrário.
  • Test-DayShift - um auxiliar privado (não exportado) que Get-ShiftKeeper pode usar.

Exporte apenas Get-ShiftKeeper. O código fornecido importa o módulo, consulta cada hora de entrada e verifica se o auxiliar está oculto.

  • 24 horas por dia
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…