Install-Package
1 つ以上のソフトウェア パッケージをインストールします。
構文
Install-Package
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Source <String[]>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ProviderName <String[]>]
[<CommonParameters>]Install-Package
[-InputObject] <SoftwareIdentity[]>
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[<CommonParameters>]説明
コマンドレットは Install-Package 、ローカル コンピューターに 1 つ以上のソフトウェア パッケージをインストールします。 複数のソフトウェア ソースがある場合は、 と Get-PackageSource を使用Get-PackageProviderして、プロバイダーに関する詳細を表示します。
重要
PackageManagement モジュールに含まれるコマンドは、Visual Studio のパッケージ マネージャー コンソールの NuGet モジュールによって提供されるコマンドとは異なります。 各モジュールには、他方では使用できないコマンドがあります。 同じ名前のコマンドは、特定の引数で異なります。 詳細については、Visual Studio のパッケージ マネージャー コンソールの PowerShell リファレンス ドキュメントを参照してください。
例
例 1: パッケージ名でパッケージをインストールする
コマンドレットは Install-Package 、ソフトウェア パッケージとその依存関係をインストールします。
PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUserInstall-Package では、パラメーターを使用してパッケージ の名前 とソースを指定 します。 Credential パラメーターは、パッケージをインストールするためのアクセス許可を持つドメイン ユーザー アカウントを使用します。 コマンドを実行すると、ユーザー アカウントのパスワードの入力を求められます。
例 2: Find-Packageを使用してパッケージをインストールする
この例では、 によって Find-Package 返されるオブジェクトがパイプラインに送信され、 によって Install-Packageインストールされます。
PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-PackageFind-Package では、 Name パラメーターと Source パラメーターを使用してパッケージを検索します。 オブジェクトがパイプラインに送信され、 Install-Package パッケージがローカル コンピューターにインストールされます。
例 3: バージョンの範囲を指定してパッケージをインストールする
Install-Package では、 MinimumVersion パラメーターと MaximumVersion パラメーターを使用して、ソフトウェア バージョンの範囲を指定します。
PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0Install-Package では、 Name パラメーターと Source パラメーターを使用してパッケージを検索します。 MinimumVersion パラメーターと MaximumVersion パラメーターは、ソフトウェア バージョンの範囲を指定します。 範囲内の最も高いバージョンがインストールされます。
パラメーター
-AcceptLicense
AcceptLicense は 、インストール時に使用許諾契約書に自動的に同意します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowClobber
既存のコマンドとの競合に関する警告メッセージをオーバーライドします。 インストールされているコマンドと同じ名前の既存のコマンドを上書きします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPrereleaseVersions
プレリリースとしてマークされたパッケージのインストールを許可します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
Install-Package は、使用可能なすべてのバージョンのパッケージをインストールします。 既定では、最新バージョンのみがインストールされます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Command
検索する 1 つ以上のコマンドを Install-Package 指定します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigFile
構成ファイルを含むパスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Contains
Install-PackageContains パラメーターがオブジェクトのプロパティ値のいずれかに一致する値を指定する場合、オブジェクトを取得します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
コンピューターにアクセスしてコマンドを実行するアクセス許可を持つユーザー アカウントを指定します。 User01、Domain01\User01 などのユーザー名を入力するか、コマンドレットによって生成された PSCredential オブジェクトをGet-Credential入力します。 ユーザー名を入力すると、パスワードの入力を求められます。
Credential パラメーターが指定されていない場合は、Install-Package現在のユーザーを使用します。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Destination
入力オブジェクトへのパスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DscResource
で検索される 1 つ以上のDesired State Configuration (DSC) リソースをInstall-Package指定します。 DSC リソースを Find-DscResource 検索するには、 コマンドレットを使用します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeVersion
フォルダー パスのバージョン番号を除外するように切り替えます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
Name プロパティと Description プロパティ内で検索する用語を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilterOnTag
結果をフィルター処理し、指定したタグを含まない結果を除外するタグを指定します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。 セキュリティを除き、成功を妨げる Install-Package 制限をオーバーライドします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceBootstrap
指定したパッケージのパッケージ プロバイダーを強制的に PackageManagement に自動的にインストールします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Headers
パッケージ ヘッダーを指定します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Includes
すべてのパッケージの種類を検索するかどうかを Install-Package 指定します。 このパラメーターに使用できる値は次のとおりです。
- コマンドレット
- DscResource
- 機能
- RoleCapability
- ワークフロー
| Type: | String[] |
| Accepted values: | Cmdlet, DscResource, Function, RoleCapability, Workflow |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
パイプライン入力を受け入れます。 パッケージの SoftwareIdentity 型を使用してパッケージを指定します。
Find-Packageは SoftwareIdentity オブジェクトを出力します。
| Type: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InstallUpdate
更新プログラムをインストールすることを Install-Package 示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
インストールする最大許容パッケージ バージョンを指定します。 このパラメーターを指定しない場合は、 Install-Package パッケージの最新バージョンをインストールします。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
インストールする最小許容パッケージ バージョンを指定します。 このパラメーターを追加しない場合は、 Install-PackageMaximumVersion パラメーターで指定されたバージョンを満たすパッケージの最新バージョンをインストールします。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
1 つ以上のパッケージ名を指定します。 複数のパッケージ名はコンマで区切る必要があります。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoPathUpdate
NoPathUpdate は コマンドレットにのみ適用されます Install-Script 。 NoPathUpdate はプロバイダーによって追加される動的パラメーターであり、 では Install-Packageサポートされていません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageManagementProvider
PackageManagement プロバイダーの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProviderName
パッケージ検索のスコープを設定する 1 つ以上のパッケージ プロバイダー名を指定します。 Get-PackageProvider コマンドレットを実行して、パッケージ プロバイダー名を取得できます。
| Type: | String[] |
| Aliases: | Provider |
| Accepted values: | Bootstrap, NuGet, PowerShellGet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Proxy
インターネット リソースに直接接続するのではなく、要求のプロキシ サーバーを指定します。
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyCredential
Proxy パラメーターで指定されたプロキシ サーバーを使用するアクセス許可を持つユーザー アカウントを指定します。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublishLocation
パッケージの発行済み場所へのパスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
インストールするパッケージの許可されている正確なバージョンを指定します。 このパラメーターを追加しない場合は、 Install-PackageMaximumVersion パラメーターで指定されたバージョンを満たすパッケージの最新バージョンをインストールします。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RoleCapability
ロール機能の配列を指定します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Scope
パッケージをインストールするスコープを指定します。 このパラメーターに使用できる値は次のとおりです。
- CurrentUser
- AllUsers
| Type: | String |
| Accepted values: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptPublishLocation
スクリプトの発行場所へのパスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptSourceLocation
スクリプト ソースの場所を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipDependencies
ソフトウェアの依存関係のインストールをスキップします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipPublisherCheck
インストールされているバージョンよりも新しいパッケージ バージョンを取得できます。 たとえば、信頼できる発行元によってデジタル署名されているが、新しいバージョンがデジタル署名されていないインストール済みパッケージなどです。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipValidate
パッケージの資格情報の検証をスキップするスイッチ。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Source
1 つ以上のパッケージ ソースを指定します。 複数のパッケージ ソース名はコンマで区切る必要があります。
コマンドレットを実行すると、パッケージ ソース名を Get-PackageSource 取得できます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
パッケージ メタデータで検索する 1 つ以上の文字列を指定します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
モジュール、スクリプト、またはその両方を使用してパッケージを検索するかどうかを指定します。 このパラメーターに使用できる値は次のとおりです。
- Module
- スクリプト
- すべて
| Type: | String |
| Accepted values: | Module, Script, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行された場合 Install-Package の動作を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
Microsoft.PackageManagement.Packaging.SoftwareIdentity
SoftwareIdentity オブジェクトをこのコマンドレットにパイプできます。
出力
Microsoft.PackageManagement.Packaging.SoftwareIdentity
このコマンドレットは、インストールするパッケージごとに SoftwareIdentity オブジェクトを返します。
メモ
コマンドにパッケージ プロバイダーを含めると、コマンドレットで動的パラメーターを使用できるようになります。 動的パラメーターは、パッケージ プロバイダーに固有です。 コマンドレットには Get-Help 、コマンドレットのパラメーター セットが一覧表示され、プロバイダーのパラメーター セットが含まれています。 たとえば、 には、Install-Packageおよび SkipPublisherCheckを含む -NoPathUpdateAllowClobberPowerShellGet パラメーター セットがあります。
重要
2020 年 4 月時点で、PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 および 1.1 がサポートされなくなります。 TLS 1.2 以降を使用していない場合、PowerShell ギャラリーにアクセスしようとするとエラーが発生します。 次のコマンドを使用して、確実に TLS 1.2 を使用するようにします。
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
詳細については、PowerShell ブログのお知らせを参照してください。
関連リンク
PowerShellGet