Update-Module
指定したモジュールの最新バージョンをオンライン ギャラリーからローカル コンピューターにダウンロードしてインストールします。
構文
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <Version>]
[-MaximumVersion <Version>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
Update-Module コマンドレットは、オンライン ギャラリーからモジュールの最新バージョンをインストールします。 インストールする前に、更新プログラムの確認を求められます。 更新プログラムは、 Install-Moduleを使用してローカル コンピューターにインストールされたモジュールに対してのみインストールされます。
Update-Module では、 $env:PSModulePath にインストールされているモジュールが検索されます。
Update-Module パラメーターが指定されていない場合は、インストールされているすべてのモジュールが更新されます。 更新するモジュールを指定するには、 Name パラメーターを使用します。 モジュールの特定のバージョンに更新するには、 RequiredVersion パラメーターを使用します。
インストールされているモジュールが既に最新バージョンの場合、モジュールは更新されません。 モジュールが $env:PSModulePathで見つからない場合は、エラーが表示されます。
インストールされているモジュールを表示するには、 Get-InstalledModuleを使用します。
例
例 1: すべてのモジュールを更新する
この例では、インストールされているすべてのモジュールをオンライン ギャラリーの最新バージョンに更新します。
Update-Module例 2: 名前でモジュールを更新する
次の使用例は、特定のモジュールをオンライン ギャラリーの最新バージョンに更新します。
Update-Module -Name SpeculationControl
Update-Module では、 Name パラメーターを使用して、特定のモジュール (SpeculationControl) を更新します。
例 3: what-if Update-Module 実行を表示する
この例では、what-if シナリオを実行して、 Update-Module が実行された場合の動作を示します。 コマンドは実行されません。
Update-Module -WhatIf
What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
'SpeculationControl', updating to version '1.0.14'".
Update-Module では、 whatIf パラメーターを使用して、 Update-Module が実行された場合に何が起こるかを表示します。
例 4: モジュールを指定したバージョンに更新する
この例では、モジュールが特定のバージョンに更新されます。 バージョンがオンライン ギャラリーに存在している必要があります。または、エラーが表示されます。
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Update-Module では、 Name パラメーターを使用してモジュール の SpeculationControl を指定します。
RequiredVersion パラメーターはバージョン 1.0.14 を指定します。
例 5: 確認なしでモジュールを更新する
この例では、オンライン ギャラリーからモジュールを最新バージョンに更新するための確認は要求しません。 モジュールが既にインストールされている場合は、 Force パラメーターによってモジュールが再インストールされます。
Update-Module -Name SpeculationControl -Force
Update-Module では、 Name パラメーターを使用してモジュール の SpeculationControl を指定します。
Force パラメーターは、ユーザーの確認を要求せずにモジュールを更新します。
パラメーター
-Confirm
Update-Moduleを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
確認を要求するプロンプトを表示せずに、指定された各モジュールの更新を強制します。 モジュールが既にインストールされている場合は、 モジュールを強制的 に再インストールします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaximumVersion
更新する 1 つのモジュールの最大バージョンを指定します。 複数のモジュールを更新しようとしている場合は、このパラメーターを追加できません。 MaximumVersion パラメーターと RequiredVersion パラメーターを同じコマンドで使用することはできません。
| 型: | Version |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
更新する 1 つ以上のモジュールの名前を指定します。
Update-Module は、 $env:PSModulePath 更新するモジュールを検索します。 指定したモジュール名の $env:PSModulePath に一致が見つからない場合は、エラーが発生します。
ワイルドカードはモジュール名で使用できます。 指定した名前にワイルドカード文字を追加しても一致する文字が見つからない場合、エラーは発生しません。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | True |
-RequiredVersion
インストールされている既存のモジュールを更新する正確なバージョンを指定します。 RequiredVersion で指定されたバージョンは、オンライン ギャラリーに存在する必要があります。または、エラーが表示されます。 1 つのコマンドで複数のモジュールが更新された場合、 RequiredVersion を使用することはできません。
| 型: | Version |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
Update-Module が実行された場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
メモ
PowerShell 5.1 以降の場合、管理者特権セッションの既定のスコープは AllUsers であり、管理者特権以外のセッションでは CurrentUser です。
AllUsers ($env:ProgramFiles\PowerShell\Modules) のモジュール更新には、昇格されたアクセス許可が必要です。
CurrentUser のモジュール更新プログラム ($home\Documents\PowerShell\Modules)、昇格されたアクセス許可は必要ありません。
Update-Module は、PowerShell の PowerShell 3.0 以降のリリース、Windows 7 または Windows 2008 R2 以降の Windows リリースで実行されます。
Name パラメーターで指定したモジュールが Install-Module を使用してインストールされなかった場合、エラーが発生します。
Update-Moduleを実行すると、オンライン ギャラリーからインストールしたモジュールでのみInstall-Moduleを実行できます。
Update-Module使用中のバイナリを更新しようとすると、Update-Moduleは問題のプロセスを識別するエラーを返します。 プロセスが停止した後、 Update-Module 再試行するようにユーザーに通知されます。