Update-PSResource
ローカル コンピューターに既にインストールされているパッケージの最新バージョンをダウンロードしてインストールします。
構文
Update-PSResource
[[-Name] <String[]>]
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Credential <PSCredential>]
[-Quiet]
[-AcceptLicense]
[-Force]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Update-PSResource
は、ローカル コンピューターに既にインストールされているパッケージの最新バージョンをダウンロードしてインストールします。 このコマンドレットは、PowerShellGet v2 のUpdate-Module
コマンドレットとUpdate-Script
コマンドレットを置き換えます。 新しいバージョンのリソースは、新しいバージョンのフォルダーに以前のバージョンと並べてインストールされます。
既定では、 Update-PSResource
インストールされている古いバージョンを削除せずに、最新バージョンのパッケージとその依存関係をインストールします。 古いバージョンのパッケージをアンインストールするコマンドはありません。 古いバージョンのファイルとフォルダーを手動で削除する必要があります。
Update-PSResource
では、更新されたモジュールが現在のセッションに読み込まれません。 更新されたモジュールを使用するには、新しいバージョンをインポートするか、新しいセッションを開始する必要があります。 詳細については、「Import-Module」を参照してください。
例
例 1
この例では、ユーザーは TestModule パッケージが既にインストールされており、パッケージを更新しています。
Get-PSResource -Name "TestModule"
Name Version Prerelease Description
---- ------- ---------- -----------
TestModule 1.2.0 test
Update-PSResource -Name "TestModule"
Name Version Prerelease Description
---- ------- ---------- -----------
TestModule 1.3.0 test
TestModule 1.2.0 test
パラメーター
-AcceptLicense
ライセンスが必要なリソースの場合、 AcceptLicense は更新中にライセンス契約に自動的に同意します。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AuthenticodeCheck
Windows 上の署名済みファイルとカタログ ファイルを検証します。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
プライベート リポジトリにアクセスするときに使用する省略可能な資格情報を指定します。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
指定すると、TrustRepository と AcceptLicense のチェックがバイパスされ、パッケージが更新されます。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
更新する 1 つ以上のリソースの名前を指定します。 ワイルドカードはサポートされていますが、NuGet は文字のみを受け入れます *
。 NuGet では、ローカル (ファイル ベース) リポジトリのワイルドカード検索はサポートされていません。
型: | String[] |
配置: | 0 |
規定値: | "*" |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
-PassThru
指定すると、保存されたリソースの PSResourceInfo オブジェクトが出力されます。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Prerelease
指定すると、プレリリース バージョンへの更新が許可されます。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Quiet
進行状況情報を抑制します。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Repository
検索する 1 つ以上のリポジトリ名を指定します。 指定しない場合、パッケージを含むリポジトリが見つかるまで、すべての登録済みリポジトリが優先順位 (最も高い順) で検索に含まれます。 リポジトリは優先度で並べ替えられた後、名前で並べ替えられます。 優先順位の値が低いほど優先順位が高くなります。
複数のリポジトリ間でリソースを 検索する場合、PSResourceGet コマンドレットは、この並べ替え順序を使用してリポジトリを検索します。 Update-PSResource
は、並べ替えられたリポジトリの一覧から最初に一致するパッケージを更新します。
このパラメーターはワイルドカード文字を *
サポートしています。 複数のリポジトリを指定する場合は、すべての名前にワイルドカード文字を含めるか省略する必要があります。 ワイルドカードの有無にかかわらず、名前の組み合わせを指定することはできません。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-Scope
インストール スコープを指定します。 指定できる値は次のとおりです。
CurrentUser
AllUsers
既定のスコープは CurrentUser
、昇格を必要としない 、です。
型: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
指定可能な値: | CurrentUser, AllUsers |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SkipDependencyCheck
リソースの依存関係のチェックをスキップします。 つまり、名前付きリソースのみが更新されます。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TemporaryPath
実際の installatoin の前にリソースを一時的にインストールするパスを指定します。 一時パスが指定されていない場合、リソースは現在のユーザーの一時フォルダーに一時的にインストールされます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TrustRepository
リポジトリを信頼するためのプロンプトを表示しない。 リポジトリを信頼するように求めるプロンプトは、リポジトリが信頼済みとして構成されていない場合にのみ発生します。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Version
返されるリソースのバージョンを指定します。 値には、NuGet のバージョン管理構文を使用して、正確なバージョンまたはバージョン範囲を指定できます。
NuGet のバージョン範囲の詳細については、「パッケージのバージョン管理」を参照してください。
PowerShellGet では、NuGet のバージョン範囲のドキュメントに 記載されている最小包括バージョン 以外のすべてをサポートしています。 バージョンとして使用 1.0.0.0
しても、バージョン 1.0.0.0 以降 (最小包括範囲) は生成されません。 代わりに、値は必要なバージョンと見なされます。 最小包括範囲を検索するには、バージョン範囲として使用 [1.0.0.0, ]
します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
String[]
出力
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
既定では、コマンドレットはオブジェクトを返しません。 PassThru パラメーターを使用すると、コマンドレットは保存されたリソースの PSResourceInfo オブジェクトを出力します。
メモ
このモジュールは、... のエイリアスUpdate-PSResource
として定義されますudres
。
関連リンク
PSResourceGet