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

Update-PSScriptFileInfo

  • Ссылка
Модуль:
Microsoft.PowerShell.PSResourceGet

Этот командлет обновляет метаданные на основе комментариев в существующем файле скрипта .ps1.

Синтаксис

Update-PSScriptFileInfo
      [-Author <String>]
      [-CompanyName <String>]
      [-Copyright <String>]
      [-Description <String>]
      [-ExternalModuleDependencies <String[]>]
      [-ExternalScriptDependencies <String[]>]
      [-Guid <Guid>]
      [-IconUri <String>]
      [-LicenseUri <String>]
      [-Path] <String>
      [-PrivateData <String>]
      [-ProjectUri <String>]
      [-ReleaseNotes <String>]
      [-RemoveSignature]
      [-RequiredModules <Hashtable[]>]
      [-RequiredScripts <String[]>]
      [-Tags <String[]>]
      [-Version <String>]
      [<CommonParameters>]

Описание

Этот командлет обновляет метаданные на основе комментариев в существующем файле скрипта .ps1. Это похоже на Update-ModuleManifest.

Примеры

Пример 1. Обновление версии скрипта

В этом примере скрипт создается с версии для 1.0.0.0. Update-PSScriptFileInfo изменяет версиина 2.0.0.0. Командлет Get-Content отображает обновленное содержимое скрипта.

$parameters = @{
    FilePath = "C:\Users\johndoe\MyScripts\test_script.ps1"
    Version = "1.0.0.0"
    Description = "this is a test script"
}
New-PSScriptFileInfo @parameters
$parameters.Version = "2.0.0.0"
Update-PSScriptFileInfo @parameters
Get-Content $parameters.FilePath

<#PSScriptInfo

.VERSION 2.0.0.0

.GUID 6ec3934e-a2e0-495b-9a9c-480e555ad1d1

.AUTHOR johndoe

.COMPANYNAME

.COPYRIGHT

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES

.PRIVATEDATA

#>

<#

.DESCRIPTION
this is a test script

#>

Параметры

-Author

Имя автора скрипта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CompanyName

Имя компании, принадлежащей скрипту.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Copyright

Сведения об авторских правах для скрипта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Описание скрипта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ExternalModuleDependencies

Список зависимостей внешнего модуля, принятых этим скриптом.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ExternalScriptDependencies

Список зависимостей внешнего скрипта, принятых этим скриптом.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Guid

Уникальный идентификатор скрипта в формате GUID.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IconUri

Универсальный идентификатор ресурса (URI), указывающий на значок, связанный со скриптом.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LicenseUri

Универсальный код ресурса (URI), указывающий на файл лицензионного соглашения, связанный с скриптом.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Имя файла и расположение скрипта.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PrivateData

Частные данные, связанные с скриптом.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProjectUri

URI, указывающий на сайт проекта, связанный с скриптом.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReleaseNotes

Заметки о выпуске скрипта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveSignature

Удаляет подпись из подписанного файла .ps1, что позволяет обновить скрипт. После обновления файла необходимо повторно подписать файл.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RequiredModules

Параметр принимает массив хэш-хэшируемых значений спецификации модуля. Спецификация модуля — это хэш-файл, имеющий следующие ключи.

  • ModuleName - Обязательный Указывает имя модуля.
  • GUID - Необязательный указывает GUID модуля.
  • Это также Обязательный, чтобы указать хотя бы один из трех приведенных ниже ключей.
    • ModuleVersion. Указывает минимальную допустимую версию модуля.
    • MaximumVersion. Указывает максимальную допустимую версию модуля.
    • RequiredVersion . Указывает точную, требуемую версию модуля. Это нельзя использовать с другими ключами версии.
Тип:Hashtable[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RequiredScripts

Список сценариев, необходимых для скрипта.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Tags

Теги, связанные со скриптом. Значения тегов — это строки, которые не должны содержать пробелы. Дополнительные сведения см. в сведения о теге.

Тип:String[]
Aliases:Tag
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Version

Версия скрипта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

Примечания

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