Sdílet prostřednictvím

Test-ScriptFileInfo

  • Reference
Modul:
PowerShellGet

Ověří blok komentáře pro skript.

Syntax

Test-ScriptFileInfo
    [-Path] <String>
    [<CommonParameters>]
Test-ScriptFileInfo
    -LiteralPath <String>
    [<CommonParameters>]

Description

Rutina Test-ScriptFileInfo ověří blok komentáře na začátku skriptu, který se publikuje pomocí rutiny Publish-Script. Pokud blok komentáře obsahuje chybu, tato rutina vrátí informace o tom, kde se chyba nachází nebo jak ji opravit.

Toto je rutina proxy pro rutinu Test-PSScriptFileInfo v Microsoft.PowerShell.PSResourceGet. Další informace najdete v tématu Test-PSScriptFileInfo.

Příklady

Příklad 1: Testování souboru skriptu

Test-ScriptFileInfo -Path "C:\temp\temp_scripts\New-ScriptFile.ps1"

Tento příkaz otestuje soubor skriptu New-ScriptFile.ps1 a zobrazí výsledky. Soubor skriptu obsahuje platná metadata.

Příklad 2: Otestování souboru skriptu, který obsahuje hodnoty pro všechny vlastnosti metadat

Test-ScriptFileInfo -Path "D:\code\Test-Runbook.ps1" | Format-List *

Name                       : Test-Runbook
Path                       : D:\code\Test-Runbook.ps1
ScriptBase                 : D:\code
ReleaseNotes               : {contoso script now supports following features, Feature 1, Feature 2, Feature 3...}
Version                    : 1.0
Guid                       : eb246b19-17da-4392-8c89-7c280f69ad0e
Author                     : pattif
CompanyName                : Microsoft Corporation
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
Tags                       : {Tag1, Tag2, Tag3}
LicenseUri                 : https://contoso.com/License
ProjectUri                 : https://contoso.com/
IconUri                    : https://contoso.com/MyScriptIcon
ExternalModuleDependencies : ExternalModule1
RequiredScripts            : {Start-WFContosoServer, Stop-ContosoServerScript}
ExternalScriptDependencies : Stop-ContosoServerScript
Description                : Contoso Script example
RequiredModules            : {RequiredModule1, @{ ModuleName = 'RequiredModule2'; ModuleVersion = '1.0' }, @{ ModuleName = 'RequiredModule3'; RequiredVersion = '2.0' }, ExternalModule1}
ExportedCommands           : {Test-WebUri, ValidateAndAdd-PSScriptInfoEntry, Get-PSScriptInfo, My-Workflow...}
ExportedFunctions          : {Test-WebUri, ValidateAndAdd-PSScriptInfoEntry, Get-PSScriptInfo, My-AdvPSCmdlet}
ExportedWorkflows          : My-Workflow

Tento příkaz otestuje soubor skriptu Test-Runbook.ps1 a pomocí operátoru kanálu předá výsledky rutině Format-List k naformátování výsledků.

Příklad 3: Testování souboru skriptu, který nemá žádná metadata

Test-ScriptFileInfo -Path "D:\code\Hello-World.ps1"

Test-ScriptFileInfo : Script 'D:\code\Hello-World.ps1' is missing required metadata properties. Verify that the script file has Version, Description
and Author properties. You can use the Update-ScriptFileInfo or New-ScriptFileInfo cmdlet to add or update the PSScriptInfo to the script file.
At line:1 char:1
+ Test-ScriptFileInfo D:\code\Hello-World.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : InvalidArgument: (D:\code\Hello-World.ps1:String) [Test-ScriptFileInfo], ArgumentException

+ FullyQualifiedErrorId : MissingRequiredPSScriptInfoProperties,Test-ScriptFile

Tento příkaz otestuje soubor skriptu Hello-World.ps1, ke kterému nejsou přidružena žádná metadata.

Parametry

-LiteralPath

Určuje cestu k jednomu nebo více umístěním. Na rozdíl od parametru Path se hodnota parametru LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete je do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, že nemá interpretovat žádné znaky jako řídicí sekvence.

Parametr je mapován na parametr Path parametru .Test-PSScriptFileInfo

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Určuje cestu k jednomu nebo více umístěním. Zástupné cardy jsou povolené. Výchozím umístěním je aktuální adresář (.).

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

Vstupy

String

Výstupy

Object