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 SpeculationControlUpdate-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.14Update-ModuleName パラメーターを使用して、モジュールである SpeculationControl を指定します。 RequiredVersion パラメーターは、バージョン 1.0.14 を指定します。
例 5: 確認なしでモジュールを更新する
この例では、オンライン ギャラリーからモジュールを最新バージョンに更新するための確認は要求しません。 モジュールが既にインストールされている場合は、 Force パラメーターによってモジュールが再インストールされます。
Update-Module -Name SpeculationControl -ForceUpdate-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
モジュールのインストール スコープを指定します。 このパラメーターに使用できる値は 、AllUsers と CurrentUser です。 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[]
出力
メモ
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 するようにユーザーに通知されます。
関連リンク
PSResourceGet