Update-PSScriptFileInfo
Этот командлет обновляет метаданные на основе комментариев в существующем файле скрипта .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. Обновление версии скрипта
В этом примере создается скрипт с параметром Version , равным 1.0.0.0
. Update-PSScriptFileInfo
изменяет значение Version' на 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
Имя автора скрипта.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompanyName
Имя компании, владеющей сценарием.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Copyright
Сведения об авторских правах для сценария.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Описание скрипта.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalModuleDependencies
Список зависимостей внешних модулей, принятых этим скриптом.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalScriptDependencies
Список зависимостей внешних скриптов, принятых этим скриптом.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Guid
Уникальный идентификатор скрипта в формате GUID.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconUri
Универсальный код ресурса (URI), указывающий на значок, связанный со сценарием.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseUri
Универсальный код ресурса (URI), указывающий на файл лицензионного соглашения, связанный со сценарием.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Имя файла и расположение скрипта.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateData
Личные данные, связанные со скриптом.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProjectUri
Универсальный код ресурса (URI), указывающий на сайт проекта, связанный со скриптом.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseNotes
Заметки о выпуске скрипта.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSignature
Удаляет подпись из подписанного .ps1
файла, позволяя обновить скрипт. После обновления файла необходимо повторно подписать .
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredModules
Параметр принимает массив хэш-таблицей спецификации модуля. Спецификация модуля — это хэш-таблице со следующими ключами.
ModuleName
- Обязательно Указывает имя модуля.GUID
- Дополнительные Указывает GUID модуля.- Кроме того, необходимо указать по крайней мере один из трех приведенных ниже ключей.
ModuleVersion
— задает минимальную допустимую версию модуля.MaximumVersion
— задает максимально допустимую версию модуля.RequiredVersion
— указывает точную требуемую версию модуля. Его нельзя использовать с другими ключами версии.
Type: | Hashtable[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredScripts
Список скриптов, необходимых для скрипта.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tags
Теги, связанные со скриптом. Значения тегов — это строки, которые не должны содержать пробелы. Дополнительные сведения см. в разделе Сведения о теге.
Type: | String[] |
Aliases: | Tag |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Версия скрипта.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
None
Выходные данные
Связанные ссылки
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по