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-PackageProvider して Get-PackageSource 表示します。

例

例 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
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowClobber

既存のコマンドとの競合に関する警告メッセージをオーバーライドします。インストールされているコマンドと同じ名前の既存のコマンドを上書きします。

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

-AllowPrereleaseVersions

プレリリースとしてマークされたパッケージのインストールを許可します。

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

-AllVersions

Install-Package は、使用可能なすべてのバージョンのパッケージをインストールします。既定では、最新バージョンのみがインストールされます。

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

-Command

検索する 1 つ以上のコマンドを Install-Package 指定します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFile

構成ファイルを含むパスを指定します。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-Contains

Install-PackageContains パラメーターがオブジェクトのプロパティ値のいずれかに一致する値を指定する場合は、オブジェクトを取得します。

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

入力オブジェクトへのパスを指定します。

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

-DscResource

で検索Install-Packageされる 1 つ以上のDesired State Configuration (DSC) リソースを指定します。コマンドレットを Find-DscResource 使用して DSC リソースを検索します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeVersion

フォルダーパスのバージョン番号を除外するように切り替えます。

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

-Filter

Name プロパティと Description プロパティ内で検索する用語を指定します。

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

-FilterOnTag

結果をフィルター処理し、指定したタグを含まない結果を除外するタグを指定します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。セキュリティを除き、成功を妨げる Install-Package 制限をオーバーライドします。

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

-ForceBootstrap

指定したパッケージのパッケージプロバイダーを自動的にインストールするように PackageManagement に強制します。

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

-Headers

パッケージヘッダーを指定します。

Type:	String[]
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

パイプライン入力を受け入れます。パッケージの SoftwareIdentity 型を使用してパッケージを指定します。 Find-Packageは SoftwareIdentity オブジェクトを出力します。

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

更新プログラムをインストールすることを Install-Package 示します。

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

-MaximumVersion

インストールするパッケージの最大許容バージョンを指定します。このパラメーターを指定しない場合は、 Install-Package パッケージの最新バージョンをインストールします。

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

-MinimumVersion

インストールする最小許容パッケージバージョンを指定します。このパラメーターを追加しない場合は、 Install-PackageMaximumVersion パラメーターで指定されたバージョンを満たすパッケージの最新バージョンをインストールします。

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

-Name

1 つ以上のパッケージ名を指定します。複数のパッケージ名はコンマで区切る必要があります。

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

-NoPathUpdate

NoPathUpdate は コマンドレットにのみ適用されます Install-Script 。 NoPathUpdate は、プロバイダーによって追加された動的パラメーターであり、サポートされていません Install-Package。

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

-PackageManagementProvider

PackageManagement プロバイダーの名前を指定します。

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

インターネットリソースに直接接続するのではなく、要求のプロキシサーバーを指定します。

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

-ProxyCredential

Proxy パラメーターで指定されたプロキシサーバーを使用するアクセス許可を持つユーザーアカウントを指定します。

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

-PublishLocation

パッケージの発行された場所へのパスを指定します。

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

-RequiredVersion

インストールするパッケージの許可される正確なバージョンを指定します。このパラメーターを追加しない場合は、 Install-PackageMaximumVersion パラメーターで指定されたバージョンを満たすパッケージの最新バージョンをインストールします。

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

-RoleCapability

ロール機能の配列を指定します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

パッケージをインストールするスコープを指定します。このパラメーターで使用できる値は次のとおりです。

CurrentUser
AllUsers

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptPublishLocation

スクリプトの発行された場所へのパスを指定します。

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

-ScriptSourceLocation

スクリプトソースの場所を指定します。

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

-SkipDependencies

ソフトウェアの依存関係のインストールをスキップします。

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

-SkipPublisherCheck

インストールされているバージョンよりも新しいパッケージバージョンを取得できます。たとえば、信頼できる発行元によってデジタル署名されているが、新しいバージョンがデジタル署名されていないインストール済みパッケージなどです。

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

-SkipValidate

パッケージの資格情報の検証をスキップするスイッチ。

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

-Source

1 つ以上のパッケージソースを指定します。複数のパッケージソース名はコンマで区切る必要があります。コマンドレットを実行すると、パッケージソース名を Get-PackageSource 取得できます。

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

-Tag

パッケージメタデータで検索する 1 つ以上の文字列を指定します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

モジュール、スクリプト、またはその両方を使用してパッケージを検索するかどうかを指定します。このパラメーターに使用できる値は次のとおりです。

Module
スクリプト
すべて

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

入力

`Install-Package` accepts input from the pipeline.

出力

SoftwareIdentity[]

メモ

コマンドにパッケージプロバイダーを含めると、コマンドレットで動的パラメーターを使用できるようになります。動的パラメーターは、パッケージプロバイダーに固有です。コマンドレットには Get-Help 、コマンドレットのパラメーターセットが一覧表示され、プロバイダーのパラメーターセットが含まれます。たとえば、 Install-PackagePowerShellGet パラメーターセットには、⾳、AllowClobberおよびを含む値が設定-NoPathUpdateされていますSkipPublisherCheck。

重要

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: バージョンの範囲を指定してパッケージをインストールする

パラメーター

入力

出力

メモ

関連リンク