Update-Module

Update-Module
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MaximumVersion <String>]
    [-Credential <PSCredential>]
    [-Scope <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update-Module コマンドレットは、オンライン ギャラリーからモジュールの最新バージョンをインストールします。 インストールする前に、更新プログラムの確認を求められます。 更新プログラムは、 Install-Moduleを使用してローカル コンピューターにインストールされたモジュールに対してのみインストールされます。 Update-Module では、 $env:PSModulePath にインストールされているモジュールが検索されます。

これは、Update-PSResource の コマンドレットのプロキシ コマンドレットです。 詳細については、「 Update-PSResource」を参照してください。

この例では、インストールされているすべてのモジュールをオンライン ギャラリーの最新バージョンに更新します。

Update-Module

次の使用例は、特定のモジュールをオンライン ギャラリーの最新バージョンに更新します。

Update-Module -Name SpeculationControl

Update-Module では、 Name パラメーターを使用して、特定のモジュール (SpeculationControl) を更新します。

この例では、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 が実行された場合に何が起こるかを表示します。

この例では、モジュールが特定のバージョンに更新されます。 バージョンがオンライン ギャラリーに存在している必要があります。または、エラーが表示されます。

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module では、 Name パラメーターを使用してモジュール の SpeculationControl を指定します。 RequiredVersion パラメーターはバージョン 1.0.14 を指定します。

この例では、オンライン ギャラリーからモジュールを最新バージョンに更新するための確認は要求しません。 モジュールが既にインストールされている場合は、 Force パラメーターによってモジュールが再インストールされます。

Update-Module -Name SpeculationControl -Force

Update-Module では、 Name パラメーターを使用してモジュール の SpeculationControl を指定します。 Force パラメーターは、ユーザーの確認を要求せずにモジュールを更新します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

PowerShell には、Update-Moduleの次のエイリアスが含まれています。

• すべてのプラットフォーム:
  • upmo

PowerShell バージョン 6.0 以降の場合、既定のインストール スコープは常に CurrentUser です。 CurrentUser のモジュール更新プログラム ($HOME\Documents\PowerShell\Modules)、昇格されたアクセス許可は必要ありません。 AllUsers ($env:ProgramFiles\PowerShell\Modules) のモジュール更新には、昇格されたアクセス許可が必要です。

PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 はサポートされなくなりました。 TLS 1.2 以降を使用する必要があります。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

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 再試行するようにユーザーに通知されます。