Test-ModuleManifest
Ellenőrzi, hogy egy modul jegyzékfájlja pontosan leírja-e egy modul tartalmát.
Syntax
Default (Alapértelmezett)
Test-ModuleManifest
[-Path] <String>
[<CommonParameters>]
Description
A Test-ModuleManifest parancsmag ellenőrzi, hogy a moduljegyzékfájlban (.psd1) szereplő fájlok ténylegesen a megadott elérési utakon találhatók-e.
Ez a parancsmag segít a modulkészítőknek a jegyzékfájljaik tesztelésében. A modulfelhasználók ezt a parancsmagot szkriptekben és parancsokban is használhatják a hibák észlelésére, mielőtt a modultól függő szkripteket futtatnának.
Test-ModuleManifest a modult jelképező objektumot ad vissza. Ez ugyanaz az objektumtípus, amelyet Get-Module visszaad. Ha bármely fájl nincs a jegyzékben megadott helyeken, a parancsmag hibát is generál az egyes hiányzó fájlok esetében.
Példák
1. példa: Jegyzék tesztelése
Test-ModuleManifest -Path "$PSHOME\Modules\TestModule.psd1"
Ez a parancs teszteli a TestModule.psd1 moduljegyzéket.
2. példa: Jegyzékfájl tesztelése a folyamat használatával
"$PSHOME\Modules\TestModule.psd1" | Test-ModuleManifest
Test-ModuleManifest : The specified type data file 'C:\Windows\System32\Wi
ndowsPowerShell\v1.0\Modules\TestModule\TestTypes.ps1xml' could not be processed because the file was not found. Please correct the path and try again.
At line:1 char:34
+ "$PSHOME\Modules\TestModule.psd1" | Test-ModuleManifest <<<<
+ CategoryInfo : ResourceUnavailable: (C:\Windows\System32\WindowsPowerShell\v1.0\Modules\TestModule\TestTypes.ps1xml:String) [Test-ModuleManifest], FileNotFoundException
+ FullyQualifiedErrorId : Modules_TypeDataFileNotFound,Microsoft.PowerShell.Commands.TestModuleManifestCommandName
Name : TestModule
Path : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\TestModule\TestModule.psd1
Description :
Guid : 6f0f1387-cd25-4902-b7b4-22cff6aefa7b
Version : 1.0
ModuleBase : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\TestModule
ModuleType : Manifest
PrivateData :
AccessMode : ReadWrite
ExportedAliases : {}
ExportedCmdlets : {}
ExportedFunctions : {}
ExportedVariables : {}
NestedModules : {}
Ez a parancs egy folyamatkezelőt (|) használ egy elérésiút-sztring Test-ModuleManifest.
A parancs kimenete azt mutatja, hogy a teszt sikertelen volt, mert a jegyzékben szereplő TestTypes.ps1xml fájl nem található.
3. példa: Függvény írása moduljegyzék teszteléséhez
function Test-ManifestBool ($path)
{$a = dir $path | Test-ModuleManifest -ErrorAction SilentlyContinue; $?}
Ez a függvény olyan, mint Test-ModuleManifest, de logikai értéket ad vissza. A függvény $true ad vissza, ha a jegyzékfájl megfelelt a tesztnek, és egyébként $false.
A függvény az Get-ChildItem alias = dir parancsmagot használja a $path változó által megadott moduljegyzék lekéréséhez. A parancs egy folyamatkezelő (|) használatával továbbítja a fájlobjektumot Test-ModuleManifest.
Test-ModuleManifest a ErrorAction gyakori paramétert használja a SilentlyContinue értékkel, hogy letiltsa a parancs által generált hibák megjelenítését. A PSModuleInfo objektumot is menti, amelyet Test-ModuleManifest a $a változóban ad vissza. Ezért az objektum nem jelenik meg.
Ezután egy külön parancsban a függvény megjeleníti az $? automatikus változó értékét. Ha az előző parancs nem okoz hibát, a parancs $truejelenik meg, és ellenkező esetben $false.
Ezt a függvényt feltételes utasításokban is használhatja, például azokat, amelyek egy Import-Module parancs vagy a modult használó parancs előtt lehetnek.
Paraméterek
-Path
Megadja a jegyzékfájl elérési útját és fájlnevét. Adja meg a .psd1 fájlnévkiterjesztéssel rendelkező moduljegyzékfájl opcionális elérési útját és nevét. Az alapértelmezett hely az aktuális könyvtár. A helyettesítő karakterek támogatottak, de egyetlen moduljegyzékfájlra kell feloldani.
Ez a paraméter kötelező. A Test-ModuleManifestútvonalát is továbbíthatja.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
String
Ehhez a parancsmaghoz a moduljegyzék elérési útját is beszűkítheti.
Kimenetek
PSModuleInfo
Ez a parancsmag egy PSModuleInfo objektumot ad vissza, amely a modult jelöli. Akkor is visszaadja ezt az objektumot, ha a jegyzékben hibák vannak.
