Register-PSRepository
PowerShell リポジトリを登録します。
構文
NameParameterSet (既定)
Register-PSRepository
[-Name] <String>
[-SourceLocation] <Uri>
[-PublishLocation <Uri>]
[-ScriptSourceLocation <Uri>]
[-ScriptPublishLocation <Uri>]
[-Credential <PSCredential>]
[-InstallationPolicy <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-PackageManagementProvider <String>]
[<CommonParameters>]
PSGalleryParameterSet
Register-PSRepository
[-Default]
[-InstallationPolicy <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[<CommonParameters>]
説明
Register-PSRepository コマンドレットは、PowerShell モジュールの既定のリポジトリを登録します。 リポジトリが登録されたら、 Find-Module、 Install-Module、および Publish-Module コマンドレットからリポジトリを参照できます。 登録済みリポジトリは、 Find-Module および Install-Moduleの既定のリポジトリになります。
登録済みリポジトリはユーザー固有です。 システム全体のコンテキストには登録されません。
登録されている各リポジトリは、 PackageManagementProvider パラメーターで指定された OneGet パッケージ プロバイダーに関連付けられます。 各 OneGet プロバイダーは、特定の種類のリポジトリと対話するように設計されています。 たとえば、NuGet プロバイダーは、NuGet ベースのリポジトリと対話するように設計されています。 登録中に OneGet プロバイダーが指定されていない場合、PowerShellGet は、指定されたソースの場所を処理できる OneGet プロバイダーの検索を試みます。
例
例 1: リポジトリを登録する
$parameters = @{
Name = "myNuGetSource"
SourceLocation = "https://www.myget.org/F/mypsrepository/api/v2"
PublishLocation = "https://www.myget.org/F/mypsrepository/api/v2/Packages"
InstallationPolicy = 'Trusted'
}
Register-PSRepository @parameters
Get-PSRepository
Name SourceLocation OneGetProvider InstallationPolicy
---- -------------- -------------- ------------------
PSGallery http://go.micro... NuGet Untrusted
myNuGetSource https://myget.c... NuGet Trusted
最初のコマンドは、 https://www.myget.org/F/mypsrepository/ を現在のユーザーのリポジトリとして登録します。 myNuGetSource が登録されたら、モジュールの検索、インストール、発行時に明示的に参照できます。
PackageManagementProvider パラメーターが指定されていないため、リポジトリは OneGet パッケージ プロバイダーに明示的に関連付けられていないため、PowerShellGet は使用可能なパッケージ プロバイダーをポーリングし、NuGet プロバイダーに関連付けます。
2 番目のコマンドは、登録済みのリポジトリを取得し、結果を表示します。
パラメーター
-Credential
リポジトリを登録する権限を持つアカウントの資格情報を指定します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Default
パラメーターは、 PSGallery を登録するために使用されます。 これは、PSGallery リポジトリを削除した場合にのみ必要です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
PSGalleryParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-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 |
パラメーター セット
NameParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PackageManagementProvider
OneGet パッケージ プロバイダーを指定します。 このパラメーターの値を指定しない場合、PowerShellGet は使用可能なパッケージ プロバイダーをポーリングし、リポジトリを処理できることを示す最初のパッケージ プロバイダーにこのリポジトリを関連付けます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Proxy
インターネット リソースに直接接続するのではなく、要求のプロキシ サーバーを指定します。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ProxyCredential
Proxy パラメーターで指定されたプロキシ サーバーを使用するアクセス許可を持つユーザー アカウントを指定します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-PublishLocation
モジュールの発行場所の URI を指定します。 たとえば、NuGet ベースのリポジトリの場合、発行場所は https://someNuGetUrl.com/api/v2/packageに似ています。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ScriptPublishLocation
スクリプトの発行場所の URI を指定します。 たとえば、NuGet ベースのリポジトリの場合、発行場所は https://someNuGetUrl.com/api/v2/package/に似ています。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ScriptSourceLocation
このリポジトリからスクリプトを検出してインストールするための URI を指定します。 URI には、NuGet サーバー フィード (最も一般的な状況)、HTTP、HTTPS、FTP、またはファイルの場所を指定できます。
たとえば、NuGet ベースのリポジトリの場合、ソースの場所は https://someNuGetUrl.com/api/v2/items/psscriptに似ています。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SourceLocation
このリポジトリからモジュールを検出してインストールするための URI を指定します。 URI には、NuGet サーバー フィード (最も一般的な状況)、HTTP、HTTPS、FTP、またはファイルの場所を指定できます。
たとえば、NuGet ベースのリポジトリの場合、ソースの場所は https://someNuGetUrl.com/api/v2に似ています。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParameterSet
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
PSCredential
Uri
出力
Object
メモ
Von Bedeutung
2020 年 4 月の時点で、PowerShell ギャラリーはトランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 をサポートしなくなりました。 TLS 1.2 以降を使用していない場合は、PowerShell ギャラリーにアクセスしようとするとエラーが表示されます。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
詳細については、PowerShell ブログの のお知らせ を参照してください。