Install-PackageProvider
1 つ以上のパッケージ管理パッケージ プロバイダーをインストールします。
構文
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>]
Install-PackageProvider
[-Scope <String>]
[-InputObject] <SoftwareIdentity[]>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
コマンドレットは Install-PackageProvider
、 PowerShellGet に登録されているパッケージ ソースで使用できる一致するパッケージ管理プロバイダーをインストールします。 既定では、これには PackageManagement タグを使用してWindows PowerShell ギャラリーで使用できるモジュールが含まれます。 PowerShellGet パッケージ管理プロバイダーは、これらのリポジトリ内のプロバイダーを検索するために使用されます。
このコマンドレットでは、パッケージ管理ブートストラップ アプリケーションを使用して使用できる一致するパッケージ管理プロバイダーもインストールされます。
このコマンドレットでは、パッケージ管理 Azure BLOB ストアで使用できる一致するパッケージ管理プロバイダーもインストールされます。 ブートストラップ プロバイダーを使用して、それらを見つけてインストールします。
PackageManagement を初めて実行するには、NuGet パッケージ プロバイダーをダウンロードするためのインターネット接続が必要です。 ただし、コンピューターにインターネット接続が存在せず、NuGet または PowerShellGet プロバイダーを使用する必要がある場合は、別のコンピューターにダウンロードして、ターゲット コンピューターにコピーできます。 これを行うには、次の手順を使用します。
- を実行
Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force
して、インターネットに接続されているコンピューターからプロバイダーをインストールします。 - インストール後、 または
$env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>
にインストールされているプロバイダーを$env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>
見つけることができます。 - フォルダー (
<ProviderName>
この場合は NuGet フォルダー) をターゲット コンピューターの対応する場所に配置します。 ターゲット コンピューターが Nano サーバーの場合は、Nano Server から を実行Install-PackageProvider
して、正しい NuGet バイナリをダウンロードする必要があります。 - PowerShell を再起動して、パッケージ プロバイダーを自動読み込みします。 または、 を実行
Get-PackageProvider -ListAvailable
して、コンピューターで使用可能なすべてのパッケージ プロバイダーを一覧表示します。 次に を使用Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201
して、プロバイダーを現在のWindows PowerShell セッションにインポートします。
例
例 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
例 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
は使用可能な最高バージョンのみを返します。
Type: | SwitchParameter |
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 |
-Credential
パッケージ プロバイダーをインストールするアクセス許可を持つユーザー アカウントを指定します。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
このコマンドレットを使用して、強制できるすべてのアクションを強制することを示します。 現時点では、Force パラメーターは ForceBootstrap パラメーターと同じように機能します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceBootstrap
このコマンドレットによってパッケージ プロバイダーが自動的にインストールされることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
SoftwareIdentity オブジェクトを指定します。 コマンドレットをFind-PackageProvider
使用して、 にパイプInstall-PackageProvider
処理する SoftwareIdentity オブジェクトを取得します。
Type: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaximumVersion
インストールするパッケージ プロバイダーの最大許容バージョンを指定します。 このパラメーターを追加しない場合は、 Install-PackageProvider
使用可能な最高バージョンのプロバイダーをインストールします。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumVersion
インストールするパッケージ プロバイダーの最小許容バージョンを指定します。 このパラメーターを追加しない場合は、 Install-PackageProvider
MaximumVersion パラメーターで指定された要件も満たす、使用可能な最高バージョンのパッケージをインストールします。
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 |
-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 |
-RequiredVersion
インストールするパッケージ プロバイダーの許可されている正確なバージョンを指定します。 このパラメーターを追加しない場合は、 Install-PackageProvider
MaximumVersion パラメーターで指定された最大バージョンも満たす、使用可能な最高バージョンのプロバイダーをインストールします。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
プロバイダーのインストール スコープを指定します。 このパラメーターの有効値は、次のとおりです。
AllUsers - コンピューターのすべてのユーザーがアクセスできる場所にプロバイダーをインストールします。 既定では、 これは $env:ProgramFiles\PackageManagement\ProviderAssemblies です。
CurrentUser - 現在のユーザーのみがアクセスできる場所にプロバイダーをインストールします。 既定では、 これは $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies です。
Type: | String |
Accepted values: | CurrentUser, AllUsers |
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 |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.PackageManagement.Packaging.SoftwareIdentity
SoftwareIdentity オブジェクトをこのコマンドレットにパイプできます。 にパイプInstall-PackageProvider
できる SoftwareIdentity オブジェクトを取得するには、 を使用Find-PackageProvider
します。
メモ
重要
2020 年 4 月時点で、PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 および 1.1 がサポートされなくなります。 TLS 1.2 以降を使用していない場合、PowerShell ギャラリーにアクセスしようとするとエラーが発生します。 次のコマンドを使用して、確実に TLS 1.2 を使用するようにします。
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
詳細については、PowerShell ブログのお知らせを参照してください。
関連リンク
PowerShellGet