次の方法で共有


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\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-ScriptNoPathUpdate はプロバイダーによって追加される動的パラメーターであり、 では 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 ブログのお知らせを参照してください。