Projeto final: relatório de alimentação do santuário
Combine importação de CSV, agrupamento, hashtables, funções avançadas e formatação em uma ferramenta real de relatórios.
- Transforme um log CSV bruto em objetos tipados e resumidos
- Compare os resultados com os limites armazenados em uma tabela hash
- Empacote a lógica como uma função avançada que retorna um objeto e formate-o na borda
Uma nota fixada na porta da sala de alimentação:
Quem quer que seja o novo guardião da automação: todas as noites eu adiciono o registro de alimentação com um lápis para ver quem foi superalimentado. Vesper continua ganhando segundos. Por favor, faça o computador fazer isso. - Guardiã-chefe Ada
O log é um arquivo CSV com uma linha por refeição:
1Time,Dragon,Food,Kg
207:00,Ember,goats,20
307:30,Glim,moths,1
4...e todo dragão tem um limite diário em quilogramas. No final, seu script imprime:
1=== EMBERFALL FEEDING REPORT ===
2Meals: 9 (07:00-18:30)
3Total: 155 kg
4Hungriest: Vesper (54 kg)
5Over limit: Ember, Vesper
6Status: ALERTPasso 1: carregue-o e verifique os tipos
ConvertFrom-Csv (ou Import-Csv para um arquivo) fornece objetos - mas cada propriedade é uma string. Verifique com Get-Member antes de confiar em qualquer aritmética:
1$log = @'
2Time,Dragon,Food,Kg
307:00,Ember,goats,20
411:00,Ember,goats,22
507:30,Glim,moths,1
6'@ | ConvertFrom-Csv
7$log.Count
8($log | Get-Member -Name Kg).Definition
9($log | Measure-Object -Property Kg -Sum).Sum3 string Kg=20 43
Measure-Object converte strings em números quando as adiciona, portanto as somas são seguras. Classificar e comparar não são - converta primeiro com [int] ou uma propriedade calculada.
Etapa 2: uma linha por dragão
Group-Object Dragon coleta as refeições de cada dragão na propriedade Group do grupo. Transforme cada grupo em um objeto de resumo organizado com [pscustomobject] - os objetos mantêm os dados utilizáveis para a próxima etapa, enquanto o texto formatado seria um beco sem saída.
1$log = @'
2Time,Dragon,Food,Kg
307:00,Ember,goats,20
411:00,Ember,goats,22
507:30,Glim,moths,1
6'@ | ConvertFrom-Csv
7$perDragon = $log | Group-Object Dragon | ForEach-Object {
8 [pscustomobject]@{
9 Dragon = $_.Name
10 Meals = $_.Count
11 Kg = ($_.Group | Measure-Object -Property Kg -Sum).Sum
12 }
13}
14$perDragon | Sort-Object Kg -Descending | ForEach-Object { '{0}: {1} kg in {2}' -f $_.Dragon, $_.Kg, $_.Meals }Ember: 42 kg in 2 Glim: 1 kg in 1
Etapa 3: compare com os limites
Uma tabela hash é o local natural para limites por dragão: $limits[$dragon] procura um instantaneamente. Proteja-se contra dragões que ainda não têm limite com .ContainsKey() - visitantes chegam o tempo todo.
1$limits = @{ Ember = 45; Glim = 2 }
2$totals = @{ Ember = 52; Glim = 1; Nimbus = 70 }
3foreach ($dragon in $totals.Keys | Sort-Object) {
4 if (-not $limits.ContainsKey($dragon)) {
5 "$dragon has no limit yet"
6 } elseif ($totals[$dragon] -gt $limits[$dragon]) {
7 '{0} is {1} kg over' -f $dragon, ($totals[$dragon] - $limits[$dragon])
8 } else {
9 "$dragon is fine"
10 }
11}Ember is 7 kg over Glim is fine Nimbus has no limit yet
Etapa 4: objetos entram, objetos saem
A ferramenta final é uma função avançada que retira refeições do pipeline e retorna um objeto de relatório. A formatação em texto acontece fora da função. Essa separação compensa: a mesma função pode alimentar um relatório de console hoje, ConvertTo-Json para um painel amanhã e um teste Pester no dia seguinte.
Import-Csv feeding.csv | Get-FeedingReport -Limit $limits | ConvertTo-JsonColete os objetos do pipeline em process e faça todo o resumo em end, assim que tudo chegar.
Para onde ir a seguir
- Agende: registre o script no Agendador de Tarefas (ou cron) para ser executado todas as noites às 20h.
- Envie: publique o relatório em um canal de bate-papo com
Invoke-RestMethod -Method Poste uma URL de webhook (consulte Web APIs, JSON e XML) ou salve-o como JSON para um painel. - Teste: escreva testes Pester para
Get-FeedingReportcom pequenos logs falsos emTestDrive:(consulte Testando com Pester e depuração). - Vá além: os módulos Az e Microsoft.Graph trazem as mesmas habilidades para Azure e Microsoft 365;
Invoke-Commandos leva para todos os servidores que você gerencia.
Principais conclusões
Verifique os tipos com Get-Member; converta texto em números antes de classificar ou comparar.
Group-Object mais
[pscustomobject]transforma linhas brutas em um resumo por coisa.Hashtables mantêm pesquisas como limites; proteja chaves perdidas com
.ContainsKey().Retorne objetos de funções e formate na borda - os mesmos dados podem então ir para qualquer lugar.
Quiz da aula
6 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á.
Refeições por dragão
A entrada é o log CSV de alimentação. Imprima uma linha por dragão, a maioria dos quilogramas primeiro: Vesper: 54 kg (2 meals) - e (1 meal), singular, quando havia apenas um.
- Um dia agitado
- Um dia tranquilo
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.
Acima do limite
A entrada é o log CSV de alimentação; o starter define $limits. Para cada dragão que comeu mais do que seu limite, em ordem alfabética, imprima Ember ate 52 kg - 7 kg over the limit of 45. Dragões sem limite nunca acabam. Se não tiver ninguém, imprima Everyone ate sensibly.
- Um dia agitado
- Um dia tranquilo
- Um visitante
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.
O relatório de alimentação
Escreva a função avançada Get-FeedingReport. Ele pega refeições do pipeline (-Meal) e uma tabela hash -Limit e retorna um objeto com estas propriedades:
Meals(a contagem),FirsteLast(os horários da primeira e da última refeição, em ordem de registro)TotalKgeHungriest- um objeto com oDragoneKgdo dragão que mais comeuOverLimit- os nomes alfabéticos dos dragões acima do seu limite (uma array vazia se não houver)
O iniciador formata seu objeto no relatório - mantenha essa parte como está:
1=== EMBERFALL FEEDING REPORT ===
2Meals: 9 (07:00-18:30)
3Total: 155 kg
4Hungriest: Vesper (54 kg)
5Over limit: Ember, Vesper
6Status: ALERT- Um dia agitado
- Um dia tranquilo
- Um visitante
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…