Get-EulModuleAboutInfo #

ÜBERSICHT #

Sammelt Manifest-Informationen eines PowerShell-Moduls für einen About-/ Über-Dialog.

SYNTAX #

Get-EulModuleAboutInfo [-ModuleName] <string> [[-LogoPath] <string>] [<CommonParameters>]

BESCHREIBUNG #

Wird typischerweise von Plugins genutzt, die im UI einen “Über”-Dialog anbieten: Modulname, Version, Beschreibung, Speicherort, Hersteller plus die deklarierten RequiredModules samt deren tatsächlich geladener Version. Optional kann eine Logo-Datei base64-eingebettet als Data-URI mitgeliefert werden, damit der Dialog ohne Datei-Referenzen rendern kann.

Zuerst wird das Modul über Get-Module gesucht (geladene Variante). Wenn dort nicht gefunden, wird -ListAvailable aus dem PSModulePath benutzt und die höchste Version genommen.

PARAMETER #

-ModuleName #

Type: string

Name des Moduls. Pflicht.

-LogoPath #

Type: string

Optional. Pfad zu einer Logo-Datei (.png/.jpg/.gif/.svg). Wird base64-eingebettet und im Feld LogoDataUri als data:-URI zurückgegeben.

AUSGABEN #

[hashtable] mit den Feldern:

ModuleName [string] Version [string] Description [string] - Beschreibung aus dem Manifest Path [string] - ModuleBase Author [string] Copyright [string] Vendor [hashtable] @{ Name; Url } - aus CompanyName + PSData.ProjectUri LogoDataUri [string] - ‘data:image/…;base64,…’ oder leer Dependencies [array] - pro RequiredModule: @{ Name; RequiredVersion; LoadedVersion; Path }

BEISPIELE #

Get-EulModuleAboutInfo -ModuleName 'EulandaXcel'

$logo = Join-Path (Get-Module EulandaXtools).ModuleBase 'lib\img\eulanda-logo.png'
Get-EulModuleAboutInfo -ModuleName 'EulandaXcel' -LogoPath $logo

HINWEISE #

Wenn das Modul nicht gefunden wird, wird eine Exception geworfen. Bei einzelnen Manifest-Feldern (Description, Author, Copyright) wird ein leerer String zurückgegeben, falls sie im Manifest fehlen.