Install-Package

リファレンス

モジュール:: PackageManagement

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\TestUser

Install-Package では、パラメーターを使用してパッケージ の名前 とソースを指定 します。 Credential パラメーターは、パッケージをインストールするためのアクセス許可を持つドメインユーザーアカウントを使用します。コマンドを実行すると、ユーザーアカウントのパスワードの入力を求められます。

例 2: Find-Packageを使用してパッケージをインストールする

この例では、によって Find-Package 返されるオブジェクトがパイプラインに送信され、によって Install-Packageインストールされます。

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-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.0

Install-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 ブログのお知らせを参照してください。

Install-Package

構文

説明

例

例 1: パッケージ名でパッケージをインストールする

例 2: Find-Packageを使用してパッケージをインストールする

例 3: バージョンの範囲を指定してパッケージをインストールする

パラメーター

-AcceptLicense

-AllowClobber

-AllowPrereleaseVersions

-AllVersions

-Command

-ConfigFile

-Confirm

-Contains

-Credential

-Destination

-DscResource

-ExcludeVersion

-Filter

-FilterOnTag

-Force

-ForceBootstrap

-Headers

-Includes

-InputObject

-InstallUpdate

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PackageManagementProvider

-ProviderName

-Proxy

-ProxyCredential

-PublishLocation

-RequiredVersion

-RoleCapability

-Scope

-ScriptPublishLocation

-ScriptSourceLocation

-SkipDependencies

-SkipPublisherCheck

-SkipValidate

-Source

-Tag

-Type

-WhatIf

入力

出力

メモ

関連リンク

フィードバック

その他のリソース