共用方式為

Update-PSScriptFileInfo

  • 參考
模組:
Microsoft.PowerShell.PSResourceGet

此 Cmdlet 會更新現有腳本 .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>]

Description

此 Cmdlet 會更新現有腳本 .ps1 檔案中的批註型中繼資料。 這與 Update-ModuleManifest 類似。

範例

範例 1：更新腳本的版本

在此範例中，會建立腳本，並將 [版本 ] 設定為 1.0.0.0 。 Update-PSScriptFileInfo 將 Version' 變更為 2.0.0.0 。 Cmdlet 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
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CompanyName

擁有腳本的公司名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Copyright

腳本的著作權資訊。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Description

腳本的描述。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ExternalModuleDependencies

此腳本所採用的外部模組相依性清單。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ExternalScriptDependencies

此腳本所採取的外部腳本相依性清單。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Guid

GUID 格式腳本的唯一識別碼。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IconUri

統一資源識別項 (URI) 指向與腳本相關聯的圖示。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LicenseUri

指向與腳本相關聯之授權合約檔案的 URI。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

腳本的檔案名和位置。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-PrivateData

與腳本相關聯的私人資料。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ProjectUri

指向與腳本相關聯之專案網站的 URI。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ReleaseNotes

腳本的版本資訊。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RemoveSignature

從已簽署 .ps1 的檔案中移除簽章，讓您更新腳本。 更新檔案之後，您應該重新簽署 。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-RequiredModules

參數接受模組規格雜湊表的陣列。 模組規格是具有下列索引鍵的雜湊表。

  • ModuleName - 必填 指定模組名稱。
  • GUID - 選 指定模組的 GUID。
  • 此外，至少必須指定下列三個索引鍵的其中一個。
    • ModuleVersion - 指定模組的最低可接受版本。
    • MaximumVersion - 指定模組可接受的最大版本。
    • RequiredVersion - 指定模組的確切必要版本。 這無法與其他版本金鑰搭配使用。
類型:Hashtable[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RequiredScripts

腳本所需的腳本清單。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Tags

與腳本相關聯的標記。 標籤值是不應包含空格的字串。 如需詳細資訊，請參閱 標記詳細資料。

類型:String[]
別名:Tag
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Version

腳本的版本。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

Object