Register-PSRepository
PowerShell リポジトリを登録します。
構文
Default (既定)
Register-PSRepository
-Name <String>
-SourceLocation <Uri>
[-PublishLocation <Uri>]
[-InstallationPolicy <String>]
[-PackageManagementProvider <String>]
[<CommonParameters>]
説明
Register-PSRepository コマンドレットは、PowerShell モジュールの既定のリポジトリを登録します。 リポジトリが登録されたら、Find-Module、Install-Module、および Publish-Module コマンドレットからリポジトリを参照できます。 登録されたリポジトリは、 Find-Module と Install-Module のデフォルトリポジトリになります。
登録済みリポジトリはユーザー固有です。 システム全体のコンテキストには登録されません。
登録されている各リポジトリは、 PackageManagementProvider パラメーターで指定された OneGet パッケージ プロバイダーに関連付けられます。 各 OneGet プロバイダーは、特定の種類のリポジトリと対話するように設計されています。 たとえば、NuGet プロバイダーは、NuGet ベースのリポジトリと対話するように設計されています。 登録中に OneGet プロバイダーが指定されていない場合、PowerShellGet は、指定されたソースの場所を処理できる OneGet プロバイダーの検索を試みます。
例
例 1: リポジトリを登録する
PS C:\> Register-PSRepository -Name "myNuGetSource" -SourceLocation "https://www.myget.org/F/powershellgetdemo/api/v2" -PublishLocation "https://www.myget.org/F/powershellgetdemo/api/v2/Packages" -InstallationPolicy Trusted
PS C:\> Get-PSRepository
Name SourceLocation OneGetProvider InstallationPolicy
---- -------------- -------------- ------------------
PSGallery http://go.micro... NuGet Untrusted
myNuGetSource https://myget.c... NuGet Trusted
最初のコマンドは、 https://www.myget.org/F/powershellgetdemo/ を現在のユーザーのリポジトリとして登録します。 myNuGetSource が登録されたら、モジュールの検索、インストール、発行時に明示的に参照できます。 PackageManagementProvider パラメーターが指定されていないため、リポジトリは OneGet パッケージ プロバイダーに明示的に関連付けられていないため、PowerShellGet は使用可能なパッケージ プロバイダーをポーリングし、NuGet プロバイダーに関連付けます。
2 番目のコマンドは、登録済みのリポジトリを取得し、結果を表示します。
パラメーター
-InstallationPolicy
インストール ポリシーを指定します。 有効な値は、Trusted、UnTrusted です。 既定値は UnTrusted です。
リポジトリのインストール ポリシーでは、そのリポジトリからインストールするときの PowerShell の動作を指定します。 UnTrusted リポジトリからモジュールをインストールすると、ユーザーに確認を求められます。
InstallationPolicy は、Set-PSRepository コマンドレットを使用して設定できます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| 指定可能な値: | Trusted, Untrusted |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
登録するリポジトリの名前を指定します。 この名前を使用して、Find-Module や Install-Module などのコマンドレットでリポジトリを指定できます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PackageManagementProvider
OneGet パッケージ プロバイダーを指定します。 このパラメーターの値を指定しない場合、PowerShellGet は使用可能なパッケージ プロバイダーをポーリングし、リポジトリを処理できることを示す最初のパッケージ プロバイダーにこのリポジトリを関連付けます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PublishLocation
発行場所の URI を指定します。 たとえば、NuGet ベースのリポジトリの場合、発行場所は http://someNuGetUrl.com/api/v2/Packagesに似ています。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SourceLocation
このリポジトリからモジュールを検出してインストールするための URI を指定します。 URI には、NuGet サーバー フィード (最も一般的な状況)、HTTP、HTTPS、FTP、またはファイルの場所を指定できます。
たとえば、NuGet ベースのリポジトリの場合、ソースの場所は http://someNuGetUrl.com/api/v2に似ています。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。