Ia-Module -ListAvailable: de Ce sau cum sunt module tipărite în secțiuni împărțite de Director?

Powershell avea propria formatare motor. Ori de câte ori utilizați ca cmdlet-ului, te ieșire o listă de System.Management.Automation.PSModuleInfo obiecte.

Înainte de imprimare obiect "prime", Powershell verifica dacă există o predefinite de formatare disponibile pentru tipul și dacă da, se aplică. Ceea ce vezi este rezultatul acestei transformări.

Până la PS 5.1, acest lucru a fost făcut prin formatarea fișierului de configurare, definit ca *.ps1xml fișiere. De la PS6.0 și mai noi, formate predefinite sunt acum incluse direct în codul sursă, dar puteți crea încă suplimentare de fișiere în format după cum este necesar.

Puteți vizualiza încărcate tip de format cu ajutorul Get-FormatData cmdlet-ului.

Dacă sunteți interesat în Get-Module cmdlet-ului în mod special, a verifica afară (Get-FormatData -TypeName System.Management.Automation.PSModuleInfo).FormatViewDefinition. Veți vedea ceva de genul asta:

Name   Control
----   -------
Module System.Management.Automation.TableControl
Module System.Management.Automation.WideControl
Module System.Management.Automation.ListControl

Acest lucru înseamnă că orice obiect de acest tip au instrucțiuni speciale cu privire la modul în care ar trebui ieșire a obiectului său. În acest caz, acesta include gruparea de cale și care afișează anumite coloane (ModuleType, Versiunea, Numele, ExportedCommands). Powershell nu a ales să se afișeze acele proprietăți în sine, ea a primit instrucțiuni de la predefinite tip pe ceea ce pentru a afișa.

În caz de PSModuleInfo tip, putem vedea că există 3 vizualizări particularizate pentru tipul. Una pentru masa de vedere (care este implicit arătat), unul pentru lista și largă, care se instrui ce să arate, atunci când utilizați Format-List & Format-Wide.

De la MS doc

Formatul de afișare pentru obiectele care sunt returnate de comenzi (cmdlet-uri, funcții, și script-uri) sunt definite prin utilizarea de formatare fișierele (în format.ps1xml fișiere). Mai multe dintre aceste fișiere sunt furnizate de către PowerShell pentru a defini formatul de afișare pentru acele obiecte returnate de PowerShell-cu condiția comenzi, cum ar fi Sistemul.Diagnosticare.Procesul obiectul returnat de la Procesul cmdlet. Cu toate acestea, puteți, de asemenea, creați-vă propriul personalizat formatare fișiere pentru a suprascrie implicit formate de afișare sau puteți scrie o formatare personalizată fișier pentru a defini afișarea de obiecte returnate de către propriile comenzi.

PowerShell utilizează datele din aceste formatare fișiere pentru a determina ce este afișat și cum datele afișate este formatat. Afișat datele pot include proprietățile unui obiect sau valoare de un script.

Puteți crea propriile fișiere (*.ps1xml) și să le includă în module sau încărcați-le în sesiuni pentru a modifica modul de ieșire este afișat.

Puteți adăuga, de asemenea, formatarea la ieșirea de funcții definind un ecran implicit setat (aka ce proprietăți ar trebui să fie afișate).

De exemplu, această funcție simplă:

  Function Get-EmployeesInfos() {
    $Output = @(
        
        [PSCustomObject]@{
            FirstName            = 'RObert'
            LastName             = 'Samson'
            SocialSecurityNumber = '123 344 555'
            Age                  = '32'
            Salary               = '100000'
        },
        
        [PSCustomObject]@{
            FirstName            = 'Pablo'
            LastName             = 'Morrison'
            SocialSecurityNumber = '123 345 555'
            Age                  = '22'
            Salary               = '10000'
        }


    )
    
    # Default display set
    $defaultDisplaySet = 'FirstName', 'LastName'
    $defaultDisplayPropertySet = New-Object System.Management.Automation.PSPropertySet('DefaultDisplayPropertySet', [string[]]$defaultDisplaySet)
    $Output | Add-Member MemberSet PSStandardMembers ([System.Management.Automation.PSMemberInfo[]]@($defaultDisplayPropertySet)) -Force
    return $Output


    return $Output
  }

Fără nici implicit de afișare set, v-ar obține de ieșire standard cu toate proprietățile enumerate.

Cu afișajul implicit set adăugat, aici este noua ieșire.

Ambele ieșiri fac conține aceleași informații, dar consola avea o formatare specială aplicată pentru a arăta doar ceea ce este cel mai important, util, etc...

Puteți utiliza formatarea vedere la:

• Colorize de ieșire
• Crea copaci
• Schimbarea de ieșire în funcție de stare
• Adăugați proprietăți virtuale
• defini lățimea coloanei
• defini afișat titlul coloanei
• etc...

Referințe:

Formatarea Fișierului De Ansamblu

4Sysops - Formatare obiect ieșire în Powershell cu Format.ps1xml fișiere

Update-FormatData

Motivul pentru care Get-Module dă rezultatul în grupuri este pentru că este formatul implicit pentru Module obiecte ori de câte ori PowerShell le prezinta pentru utilizator. Nu e o trăsătură specifică a Get-Module cmdlet-ului ca atare.

Acest lucru este convenabil facilitate, în general, pentru că puteți apoi utilizați cmdlet-uri, cum ar fi Sort-Object și Where-Object pentru a sorta și filtra rezultatele și apoi au rezultatele prezentate în grupuri după aceea.

În următorul exemplu, rezultatele sunt filtrate și apoi afișate în grupuri. Semnificația este că nici Get-Module nici Where-Object este conștient de faptul că rezultatul final va fi afișat în grupuri; au de-a face doar cu obiecte.

PS> Get-Module -ListAvailable | Where-Object Name -Match Read

    Directory: C:\program files\powershell\7\Modules

ModuleType Version    PreRelease Name
---------- -------    ---------- ----
Script     2.1.0                 PSReadLine                          ...
Binary     2.0.3                 ThreadJob                           ...

    Directory: C:\Program Files\WindowsPowerShell\Modules

ModuleType Version    PreRelease Name
---------- -------    ---------- ----
Script     2.0.0      beta2      PSReadline                          ...

Puteți vedea ce PowerShell este de a face în acest caz specific, uitandu-se la formatarea implicită cod pentru module de pe GitHub. Partea relevantă este GroupByScriptBlock apel (cu mici reformatarea pentru a reduce lungimea liniei):

yield return new FormatViewDefinition("Module",
    TableControl.Create()
        .GroupByScriptBlock(@"
            Split-Path -Parent $_.Path | ForEach-Object {
                if([Version]::TryParse((Split-Path $_ -Leaf), [ref]$null)) {
                    Split-Path -Parent $_
                } else {
                    $_
                }
            } | Split-Path -Parent", customControl: sharedControls[0])
        .AddHeader(Alignment.Left, width: 10)

        ...

Când PowerShell prezinta o serie de module de obiecte pentru utilizator folosind formatul implicit, acesta va rula script-ul în bloc GroupByScriptBlock pe fiecare obiect în primul rând pentru a lucra în grup.