Update-PSScriptFileInfo
Tato rutina aktualizuje metadata založená na komentářích v existujícím souboru skriptu .ps1
.
Syntaxe
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>]
Description
Tato rutina aktualizuje metadata založená na komentářích v existujícím souboru skriptu .ps1
. Je to podobné jako Update-ModuleManifest
.
Příklady
Příklad 1: Aktualizace verze skriptu
V tomto příkladu se vytvoří skript s verzí nastavenou na 1.0.0.0
.
Update-PSScriptFileInfo
změní verzi na 2.0.0.0
. Rutina Get-Content
zobrazí aktualizovaný obsah skriptu.
$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
#>
Parametry
-Author
Jméno autora skriptu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CompanyName
Název společnosti, která skript vlastní.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Copyright
Informace o autorských právech pro skript.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Description
Popis skriptu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ExternalModuleDependencies
Seznam závislostí externích modulů pořízených tímto skriptem
Typ: | String[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ExternalScriptDependencies
Seznam závislostí externích skriptů pořízených tímto skriptem.
Typ: | String[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Guid
Jedinečný identifikátor skriptu ve formátu GUID.
Typ: | Guid |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-IconUri
Identifikátor URI (Uniform Resource Identifier) odkazující na ikonu přidruženou ke skriptu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-LicenseUri
Identifikátor URI odkazující na soubor licenční smlouvy přidružený ke skriptu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Path
Název souboru a umístění skriptu.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PrivateData
Soukromá data přidružená ke skriptu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ProjectUri
Identifikátor URI odkazující na web projektu přidružený ke skriptu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ReleaseNotes
Poznámky k verzi skriptu
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-RemoveSignature
Odebere podpis z podepsaného .ps1
souboru a umožní vám aktualizovat skript. Po aktualizaci souboru byste ho měli znovu podepsat.
Typ: | SwitchParameter |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-RequiredModules
Parametr přebírá pole hodnot hashtables specifikace modulu. Specifikace modulu je zatřiďovací tabulka, která má následující klíče.
-
ModuleName
- Požadované Určuje název modulu. -
GUID
- Volitelné Určuje identifikátor GUID modulu. - Je také nutné zadat alespoň jeden ze tří níže uvedených klíčů.
-
ModuleVersion
– Určuje minimální přijatelnou verzi modulu. -
MaximumVersion
– Určuje maximální přijatelnou verzi modulu. -
RequiredVersion
– Určuje přesnou a požadovanou verzi modulu. Tuto možnost nelze použít s jinými klíči verze.
-
Typ: | Hashtable[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-RequiredScripts
Seznam skriptů vyžadovaných skriptem
Typ: | String[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Tags
Značky přidružené ke skriptu. Hodnoty značek jsou řetězce, které by neměly obsahovat mezery. Další informace najdete v tématu Podrobnosti o značkách.
Typ: | String[] |
Aliasy: | Tag |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Version
Verze skriptu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
None