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 インストールされているモジュールを検索します。

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

例

例 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-ModuleName パラメーターを使用して、モジュールである SpeculationControl を指定します。 RequiredVersion パラメーターは、バージョン 1.0.14 を指定します。

例 5: 確認なしでモジュールを更新する

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

Update-Module -Name SpeculationControl -Force

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

パラメーター

-AcceptLicense

-AllowPrerelease

-Confirm

-Credential

-Force

-MaximumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-RequiredVersion

-Scope

-WhatIf

入力

String[]

String

PSCredential

Uri

出力

Object

メモ

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-ModuleInstall-Moduleできます。

Update-Module使用中のバイナリを更新しようとすると、Update-Module問題のプロセスを識別するエラーが返されます。 プロセスが停止した後に再試行 Update-Module するようにユーザーに通知されます。

関連リンク

• Find-Module
• Get-InstalledModule
• Install-Module
• Publish-Module
• Uninstall-Module