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-PackageProviderPowerShellGet に登録されているパッケージ ソースで使用できる一致するパッケージ管理プロバイダーをインストールします。 既定では、これには PackageManagement タグを使用してWindows PowerShell ギャラリーで使用できるモジュールが含まれます。 PowerShellGet パッケージ管理プロバイダーは、これらのリポジトリ内のプロバイダーを検索するために使用されます。

このコマンドレットでは、パッケージ管理ブートストラップ アプリケーションを使用して使用できる一致するパッケージ管理プロバイダーもインストールされます。

このコマンドレットでは、パッケージ管理 Azure BLOB ストアで使用できる一致するパッケージ管理プロバイダーもインストールされます。 ブートストラップ プロバイダーを使用して、それらを見つけてインストールします。

PackageManagement を初めて実行するには、NuGet パッケージ プロバイダーをダウンロードするためのインターネット接続が必要です。 ただし、コンピューターにインターネット接続が存在せず、NuGet または PowerShellGet プロバイダーを使用する必要がある場合は、別のコンピューターにダウンロードして、ターゲット コンピューターにコピーできます。 これを行うには、次の手順を使用します。

  1. を実行 Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force して、インターネットに接続されているコンピューターからプロバイダーをインストールします。
  2. インストール後、 または $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>にインストールされているプロバイダーを$env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>見つけることができます。
  3. フォルダー ( <ProviderName> この場合は NuGet フォルダー) をターゲット コンピューターの対応する場所に配置します。 ターゲット コンピューターが Nano サーバーの場合は、Nano Server から を実行 Install-PackageProvider して、正しい NuGet バイナリをダウンロードする必要があります。
  4. 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-PackageProviderMaximumVersion パラメーターで指定された要件も満たす、使用可能な最高バージョンのパッケージをインストールします。

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-PackageProviderMaximumVersion パラメーターで指定された最大バージョンも満たす、使用可能な最高バージョンのプロバイダーをインストールします。

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