次の方法で共有

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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CompanyName

スクリプトを所有している会社の名前。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Copyright

スクリプトの著作権情報。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

スクリプトの説明。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExternalModuleDependencies

このスクリプトによって取得された外部モジュールの依存関係の一覧。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExternalScriptDependencies

このスクリプトによって取得された外部スクリプトの依存関係の一覧。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Guid

GUID 形式のスクリプトの一意識別子。

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IconUri

スクリプトに関連付けられているアイコンを指す URI (Uniform Resource Identifier)。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LicenseUri

スクリプトに関連付けられている使用許諾契約書ファイルを指す URI。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

スクリプトのファイル名と場所。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrivateData

スクリプトに関連付けられているプライベート データ。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProjectUri

スクリプトに関連付けられているプロジェクト サイトを指す URI。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReleaseNotes

スクリプトのリリース ノート。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveSignature

署名された .ps1 ファイルから署名を削除し、スクリプトを更新できるようにします。 ファイルを更新した後に、再署名する必要があります。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RequiredModules

このパラメーターは、モジュール仕様ハッシュテーブルの配列を受け取ります。 モジュール仕様は、次のキーを持つハッシュテーブルです。

  • ModuleName - 必須 モジュール名を指定します。
  • GUID - 省略可能 モジュールの GUID を指定します。
  • また、以下の 3 つのキーのうち少なくとも 1 つを指定する必要 も。
    • ModuleVersion - モジュールの最小許容バージョンを指定します。
    • MaximumVersion - モジュールの許容される最大バージョンを指定します。
    • RequiredVersion - モジュールの正確で必要なバージョンを指定します。 これは、他のバージョン キーでは使用できません。
型:Hashtable[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RequiredScripts

スクリプトに必要なスクリプトの一覧。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Tags

スクリプトに関連付けられているタグ。 タグ値は、スペースを含めてはならない文字列です。 詳細については、「タグの詳細 参照してください。

型:String[]
Aliases:Tag
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Version

スクリプトのバージョン。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

メモ

New-PSScriptFileInfo および Update-PSScriptFileInfo コマンドレットは、ヘルプ ファイルの #requires とコメント ベースのヘルプ ブロックの間に、必要なモジュールの <#PSScriptInfo ステートメントを配置します。 Get-PSScriptFileInfo では、コメント ベースのヘルプ ブロックの前のどこかに #requires ステートメントが配置されることを想定しています。 コメント ベースのヘルプ ブロックの後に配置された #requires ステートメントは、Get-PSScriptFileInfo および Publish-PSResourceによって無視されます。