Update-PSScriptFileInfo

Modul:

Microsoft.PowerShell.PSResourceGet Module

Tato rutina aktualizuje metadata založená na komentářích v existujícím souboru skriptu .ps1.

Syntax

Default (Výchozí)

Update-PSScriptFileInfo
    [-Path] <string>
    [-Author <string>]
    [-CompanyName <string>]
    [-Copyright <string>]
    [-Description <string>]
    [-ExternalModuleDependencies <string[]>]
    [-ExternalScriptDependencies <string[]>]
    [-Guid <guid>]
    [-IconUri <string>]
    [-LicenseUri <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. To se podobá Update-ModuleManifest.

Příklady

Příklad 1: Aktualizace verze skriptu

V tomto příkladu se vytvoří skript s verze nastavenou na 1.0.0.0. Update-PSScriptFileInfo změní verzina 2.0.0.0. Rutina Get-Content zobrazuje 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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CompanyName

Název společnosti, která skript vlastní.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Copyright

Informace o autorských právech pro skript

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Description

Popis skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ExternalModuleDependencies

Seznam závislostí externích modulů přijatých tímto skriptem

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ExternalScriptDependencies

Seznam závislostí externích skriptů přijatých tímto skriptem

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Guid

Jedinečný identifikátor skriptu ve formátu GUID.

Vlastnosti parametru

Typ:	Guid
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IconUri

Identifikátor URI (Uniform Resource Identifier) odkazující na ikonu přidruženou ke skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-LicenseUri

Identifikátor URI odkazující na soubor licenční smlouvy přidružený ke skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Path

Název souboru a umístění skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PrivateData

Privátní data přidružená ke skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ProjectUri

Identifikátor URI odkazující na web projektu přidružený ke skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ReleaseNotes

Poznámky k verzi skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RemoveSignature

Odebere podpis ze podepsaného souboru .ps1, který umožňuje aktualizovat skript. Po aktualizaci souboru byste měli soubor znovu podepsat.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RequiredModules

Parametr přebírá pole hashtable specifikace modulu. Specifikace modulu je hashovatelná tabulka s následujícími klíči.

• ModuleName - Povinný Určuje název modulu.
• GUID - Volitelné Určuje identifikátor GUID modulu.
• Je také Povinné zadat aspoň jeden z následujících tří klíčů.
  • ModuleVersion – Určuje minimální přijatelnou verzi modulu.
  • MaximumVersion – Určuje maximální přijatelnou verzi modulu.
  • RequiredVersion – Určuje přesnou požadovanou verzi modulu. Tuto možnost nelze použít s jinými klíči verze.

Vlastnosti parametru

Typ:	Hashtable[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RequiredScripts

Seznam skriptů požadovaných skriptem

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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 značky.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Štítek

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Version

Verze skriptu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Výstupy

Object

Poznámky

Rutiny New-PSScriptFileInfo a Update-PSScriptFileInfo umístí příkazy #requires pro požadované moduly mezi bloky nápovědy <#PSScriptInfo a bloky nápovědy založené na komentářích. Get-PSScriptFileInfo očekává, že se #requires příkazy umístí někam před blok nápovědy založený na komentáři. Všechny příkazy #requires umístěné po bloku nápovědy založené na komentářích se ignorují Get-PSScriptFileInfo a Publish-PSResource.

Související odkazy

• Get-PSScriptFileInfo
• Update-PSScriptFileInfo
• Test-PSScriptFileInfo
• Pokyny a osvědčené postupy pro publikování v PowerShellGallery
• Hodnoty manifestu balíčku, které mají vliv na uživatelské rozhraní galerie Prostředí PowerShell