Поделиться через

Test-PSScriptFileInfo

Модуль:
Microsoft.PowerShell.PSResourceGet Module

Проверяет метаданные на основе комментариев в файле .ps1, чтобы убедиться, что он действителен для публикации.

Синтаксис

Default (По умолчанию) 

Test-PSScriptFileInfo
    [-Path] <String>
    [<CommonParameters>]

Описание

Этот командлет проверяет метаданные на основе комментариев в файле .ps1, чтобы убедиться, что он действителен для публикации в репозитории.

Примеры

Пример 1. Проверка допустимого скрипта

В этом примере создается новый файл скрипта, а затем выполняется Test-PSScriptFile для проверки метаданных в скрипте.

New-PSScriptFileInfo -Path "C:\MyScripts\test_script.ps1" -Description "this is a test script"
Test-PSScriptFileInfo -Path "C:\MyScripts\test_script.ps1"
True

Пример 2. Проверка недопустимого скрипта (отсутствующий автор)

В этом примере выполняется командлет Test-PSScriptFile в файле скрипта. Скрипт отсутствует необходимые метаданные Author. Командлет записывает предупреждение и возвращает $false. Get-Content используется для просмотра содержимого файла скрипта.

Test-PSScriptFileInfo -Path "C:\MyScripts\invalid_test_script.ps1"
Get-Content "C:\MyScripts\invalid_test_script.ps1"

WARNING: The .ps1 script file passed in wasn't valid due to: PSScript file is missing the required
Author property
False
<#PSScriptInfo

.VERSION 1.0.0.0

.GUID 7ec4832e-a4e1-562b-8a8c-241e535ad7d7

.AUTHOR

.COMPANYNAME

.COPYRIGHT

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES

.PRIVATEDATA

#>

<#

.DESCRIPTION
this is a test script

#>

Параметры

-Path

Путь к файлу скрипта .ps1.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:0
Обязательный:True
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входы

None

Выходы

Boolean

Примечания

Командлеты New-PSScriptFileInfo и Update-PSScriptFileInfo размещают инструкции #requires для необходимых модулей между блоками справки на основе <#PSScriptInfo и комментариев файла справки. Get-PSScriptFileInfo ожидает, что операторы #requires помещаются где-то перед блоком справки на основе комментариев. Все инструкции #requires, размещенные после блока справки на основе комментариев, игнорируются Get-PSScriptFileInfo и Publish-PSResource.