PowerShell-tuki Maguyva-palvelussa: koodigraafit skripteille ja moduuleille

Missä PowerShell kampittaa pinnallisia tekoälytyökaluja

Omat funktiosi ja sisäänrakennetut cmdletit noudattavat samaa nimeämistyyliä. Get-Invoice ja Get-ChildItem näyttävät samalta, joten työkalu, joka karsii ”sisäänrakennetut” komennot verbin perusteella, heittää pois myös omat funktiosi. Skriptit sekoittavat lisäksi moduulitason koodia, funktioita, luokkia ja skriptilohkoja samaan tiedostoon, joten on vaikea nähdä, mihin funktioon jokin rivi kuuluu.

Maguyva säilyttää molemmat kutsutyypit ja liittää jokaisen kutsun funktioon, jossa se on.

Mitä Maguyva poimii PowerShell-koodista

Maguyva kattaa .ps1-, .psm1- ja .psd1-tiedostot. Funktiot ja luokkien metodit poimitaan kutsuttavina, ja luokat ja luettelotyypit tyyppeinä. Skriptien ja metodien parametreja seurataan, ja funktion sisäiset luvut ja kirjoitukset liitetään kyseiseen funktioon eikä moduuliin.

Cmdlet-kutsut jäävät graafiin. PowerShell ei käytä useimpien kielten standardikirjastosuodatinta, joten Write-Host, Get-ChildItem ja Restart-Service näkyvät kutsukaarina omien Get-*- ja Set-*-funktioidesi rinnalla. Agentti voi kysyä, mitkä skriptit käynnistävät palvelun uudelleen tai mitkä funktiot kirjoittavat konsoliin, ja saada rakenteeseen perustuvan vastauksen.

PowerShell-koodille yhtään suhdetyyppiä ei ole merkitty soveltumattomaksi, joten graafi tallentaa myös luokkaperinnän ja rajapintojen toteutukset, instanssien luonnit, ohjausvuon sekä luvut ja kirjoitukset.

Esimerkkikehotteita agenteille

• ”Kuka kutsuu funktiota Invoke-Backup ja mistä ajastetuista skripteistä?” (find_symbol, sitten dependency_search incoming)
• ”Mitkä funktiot kutsuvat cmdletiä Restart-Service?” (dependency_search)
• ”Jäljitä, mitä Deploy-Site tekee alusta loppuun.” (get_task_context)

Tunnetut rajoitukset

• Koska cmdlet-kutsut säilytetään, hyvin yleisillä cmdleteillä kuten Write-Host ja Select-Object on valtava määrä saapuvia kaaria. Aloita omasta funktiostasi, kun haluat rajatun kutsugraafin.
• Import-Module ja dot-sourcing ovat tavallisia komentoja, joten structural_search-työkalun esiasetus imports ei valitse mitään. Käytä niiden listaamiseen text_pattern_search-työkalua.

Seuraavat vaiheet

Yhdistä repositorio pikaoppaan avulla ja tarkista sitten tukimatriisi yhteensopivuussivulta. Skriptiesi kutsumaa .NET-koodia varten lue C#-opas.