次の方法で共有


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

パッケージに必要な場合は、インストール中にライセンス契約に自動的に同意します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPrerelease

プレリリースとしてマークされた新しいモジュールを使用してモジュールを更新できます。

プロキシ コマンドレットは、このパラメーターを の Prerelease パラメーターにマップします Update-PSResource

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

を実行する前に確認を求めるメッセージが表示されます Update-Module

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

モジュールを更新するアクセス許可を持つユーザー アカウントを指定します。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

確認を要求するプロンプトを表示せずに、指定した各モジュールの更新を強制します。 モジュールが既にインストールされている場合は、 モジュールを強制的 に再インストールします。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

プロキシ コマンドレットでは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Update-PSResource

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

更新する 1 つ以上のモジュールの名前を指定します。 Update-Module は、 $env:PSModulePath 更新するモジュールを検索します。 指定したモジュール名に $env:PSModulePath 一致するが見つからない場合は、エラーが発生します。

ワイルドカードはモジュール名で使用できます。 指定した名前にワイルドカード文字を追加し、一致する文字が見つからない場合、エラーは発生しません。

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

プロキシ コマンドレットではサポートされていないため、このパラメーターは無視されます Update-PSResource

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

プロキシ コマンドレットではサポートされていないため、このパラメーターは無視されます Update-PSResource

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

プロキシ コマンドレットでは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Update-PSResource

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

モジュールのインストール スコープを指定します。 このパラメーターに使用できる値は 、AllUsersCurrentUser ですScope が指定されていない場合、更新プログラムは CurrentUser スコープにインストールされます。

AllUsers スコープには管理者特権のアクセス許可が必要であり、コンピューターのすべてのユーザーがアクセスできる場所にモジュールをインストールします。

$env:ProgramFiles\PowerShell\Modules

CurrentUser は管理者特権のアクセス許可を必要とせず、コンピューターの現在のユーザーのみがアクセスできる場所にモジュールをインストールします。

$HOME\Documents\PowerShell\Modules

スコープが定義されていない場合、既定値は PowerShellGet バージョンに基づいて設定されます。

  • PowerShellGet バージョン 2.0.0 以降では、既定値は CurrentUser であり、インストールに昇格は必要ありません。
  • PowerShellGet 1.x バージョンでは、既定値は AllUsers であり、インストールには昇格が必要です。
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

が実行された場合 Update-Module の動作を示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

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