Install-PackageProvider
1 つ以上のパッケージ管理パッケージ プロバイダーをインストールします。
構文
PackageBySearch (既定)
Install-PackageProvider
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Source <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
PackageByInputObject
Install-PackageProvider
[-InputObject] <SoftwareIdentity[]>
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Install-PackageProvider コマンドレットは、PowerShellGet に登録されているパッケージ ソースで使用できる一致するパッケージ管理プロバイダーをインストールします。 既定では、これには 、PackageManagement タグを持つ Windows PowerShell ギャラリーで使用できるモジュールが含まれます。
PowerShellGet パッケージ管理プロバイダーは、これらのリポジトリ内のプロバイダーを検索するために使用されます。
このコマンドレットは、パッケージ管理ブートストラップ アプリケーションを使用して使用できる一致するパッケージ管理プロバイダーもインストールします。
例
例 1: PowerShell ギャラリーからパッケージ プロバイダーをインストールする
このコマンドは、PowerShell ギャラリーから GistProvider パッケージ プロバイダーをインストールします。
Install-PackageProvider -Name "GistProvider" -Verbose
例 2: 指定したバージョンのパッケージ プロバイダーをインストールする
この例では、指定したバージョンの NuGet パッケージ プロバイダーをインストールします。
最初のコマンドは、NuGet という名前のパッケージ プロバイダーのすべてのバージョンを検索します。 2 番目のコマンドは、指定したバージョンの NuGet パッケージ プロバイダーをインストールします。
Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force
NuGet パッケージ プロバイダーをインストールする必要があるのは、Windows PowerShell で PackageManagement v1.1.0.0 を実行している場合のみです。 新しいバージョンの PowerShellGet と PackageManagement には、既定で NuGet パッケージ プロバイダーが含まれています。
例 3: プロバイダーを検索してインストールする
この例では、 Find-PackageProvider とパイプラインを使用して Gist プロバイダーを検索してインストールします。
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose
例 4: 現在のユーザーのモジュール フォルダーにプロバイダーをインストールする
このコマンドは、現在のユーザーのみが使用できるように、 $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies するパッケージ プロバイダーをインストールします。
Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser
パラメーター
-AllVersions
このコマンドレットは、使用可能なすべてのバージョンのパッケージ プロバイダーをインストールすることを示します。 既定では、 Install-PackageProvider は使用可能な最高バージョンのみを返します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Credential
パッケージ プロバイダーをインストールするアクセス許可を持つユーザー アカウントを指定します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PackageBySearch
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
このコマンドレットが、強制的に実行できるこのコマンドレットを使用して、すべてのアクションを強制的に実行することを示します。 現時点では、Force パラメーターは ForceBootstrap パラメーターと同じように動作します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ForceBootstrap
このコマンドレットによってパッケージ プロバイダーが自動的にインストールされることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InputObject
SoftwareIdentity オブジェクトを指定します。
Find-PackageProvider コマンドレットを使用して、にパイプする Install-PackageProvider オブジェクトを取得します。
パラメーターのプロパティ
| 型: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PackageByInputObject
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaximumVersion
インストールするパッケージ プロバイダーの最大許容バージョンを指定します。 このパラメーターを追加しない場合、 Install-PackageProvider は使用可能な最高バージョンのプロバイダーをインストールします。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PackageBySearch
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MinimumVersion
インストールするパッケージ プロバイダーの最小許容バージョンを指定します。 このパラメーターを追加しない場合、 Install-PackageProvider は 、MaximumVersion パラメーターで指定された要件も満たす、使用可能な最高バージョンのパッケージをインストールします。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PackageBySearch
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
1 つ以上のパッケージ プロバイダー モジュール名を指定します。 複数のパッケージ名をコンマで区切ります。 ワイルドカード文字はサポートされていません。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PackageBySearch
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Proxy
インターネット リソースに直接接続するのではなく、要求のプロキシ サーバーを指定します。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProxyCredential
Proxy パラメーターで指定されたプロキシ サーバーを使用するアクセス許可を持つユーザー アカウントを指定します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RequiredVersion
インストールするパッケージ プロバイダーの許可されている正確なバージョンを指定します。 このパラメーターを追加しない場合、 Install-PackageProvider は 、MaximumVersion パラメーターで指定された最大バージョンも満たす、使用可能な最新バージョンのプロバイダーをインストールします。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PackageBySearch
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Scope
プロバイダーのインストール スコープを指定します。 このパラメーターに使用できる値は次のとおりです。
AllUsers - コンピューターのすべてのユーザーがアクセスできる場所にプロバイダーをインストールします。 既定では、 これは $env:ProgramFiles\PackageManagement\ProviderAssemblies です。
CurrentUser - 現在のユーザーのみがアクセスできる場所にプロバイダーをインストールします。 既定では、 これは $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| 指定可能な値: | CurrentUser, AllUsers |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Source
1 つ以上のパッケージ ソースを指定します。
Get-PackageSource コマンドレットを使用して、使用可能なパッケージ ソースの一覧を取得します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PackageBySearch
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
Microsoft.PackageManagement.Packaging.SoftwareIdentity
SoftwareIdentity オブジェクトをこのコマンドレットにパイプできます。
Find-PackageProviderを使用して、にパイプできる Install-PackageProvider オブジェクトを取得します。
メモ
Von Bedeutung
2020 年 4 月の時点で、PowerShell ギャラリーはトランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 をサポートしなくなりました。 TLS 1.2 以降を使用していない場合は、PowerShell ギャラリーにアクセスしようとするとエラーが表示されます。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
詳細については、PowerShell ブログの のお知らせ を参照してください。
