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.
- 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.
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'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
.psm1de funções.Import-Module .\Dragons.psm1carrega eExport-ModuleMemberescolhe quais funções são públicas - os ajudantes permanecem privados. Coloque uma pasta de módulo em um dos caminhos em$env:PSModulePathe ele carrega automaticamente na primeira vez que você chama um de seus comandos.
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 DragonsEmber 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 blocoparam(); use$PSScriptRootpara 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.psm1para compartilhá-los corretamente.Install-Moduleobtém módulos da Galeria do PowerShell;$PROFILEpersonaliza 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á.
Um script com parâmetros
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
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.
Construir um módulo
Escreva um módulo Keepers.psm1 (o starter salva em uma pasta temporária) contendo duas funções:
Get-ShiftKeeper -Hour <int>retornaAdapara as horas 6-13,Gracepara 14-21 eLinuscaso contrário.Test-DayShift- um auxiliar privado (não exportado) queGet-ShiftKeeperpode 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
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…