Register-PSRepository

  • リファレンス
モジュール:
PowerShellGet

PowerShell リポジトリを登録します。

構文

Register-PSRepository
        [-Name] <String>
        [-SourceLocation] <Uri>
        [-PublishLocation <Uri>]
        [-ScriptSourceLocation <Uri>]
        [-ScriptPublishLocation <Uri>]
        [-Credential <PSCredential>]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [-PackageManagementProvider <String>]
        [<CommonParameters>]
Register-PSRepository
        [-Default]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [<CommonParameters>]

説明

コマンドレットは Register-PSRepository 、PowerShell モジュールの既定のリポジトリを登録します。 リポジトリが登録されたら、および コマンドレットからリポジトリをFind-ModuleInstall-ModulePublish-Module参照できます。 登録済みリポジトリは、 および Install-Moduleの既定のFind-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

リポジトリを登録する権限を持つアカウントの資格情報を指定します。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Default

パラメーターは、 PSGallery の登録に使用されます。 これを行う必要があるのは、 PSGallery リポジトリを削除した場合のみです。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InstallationPolicy

インストール ポリシーを指定します。 有効な値は、Trusted、UnTrusted です。 既定値は UnTrusted です。

リポジトリのインストール ポリシーでは、そのリポジトリからインストールするときの PowerShell の動作を指定します。 UnTrusted リポジトリからモジュールをインストールすると、ユーザーに確認を求められます。

コマンドレットを使用して InstallationPolicy を Set-PSRepository 設定できます。

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

登録するリポジトリの名前を指定します。 この名前を使用して、 や Install-ModuleなどのFind-Moduleコマンドレットでリポジトリを指定できます。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

OneGet パッケージ プロバイダーを指定します。 このパラメーターの値を指定しない場合、PowerShellGet は使用可能なパッケージ プロバイダーをポーリングし、リポジトリを処理できることを示す最初のパッケージ プロバイダーにこのリポジトリを関連付けます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

インターネット リソースに直接接続するのではなく、要求のプロキシ サーバーを指定します。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Proxy パラメーターに指定したプロキシ サーバーを使用するアクセス許可を持つユーザー アカウントを指定します。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublishLocation

モジュールの発行場所の URI を指定します。 たとえば、NuGet ベースのリポジトリの場合、発行場所は に https://someNuGetUrl.com/api/v2/package似ています。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptPublishLocation

スクリプトの発行場所の URI を指定します。 たとえば、NuGet ベースのリポジトリの場合、発行場所は に https://someNuGetUrl.com/api/v2/package/似ています。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptSourceLocation

このリポジトリからスクリプトを検出してインストールするための URI を指定します。 URI には、NuGet サーバー フィード (最も一般的な状況)、HTTP、HTTPS、FTP、またはファイルの場所を指定できます。

たとえば、NuGet ベースのリポジトリの場合、ソースの場所は と https://someNuGetUrl.com/api/v2/items/psscript似ています。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceLocation

このリポジトリからモジュールを検出してインストールするための URI を指定します。 URI には、NuGet サーバー フィード (最も一般的な状況)、HTTP、HTTPS、FTP、またはファイルの場所を指定できます。

たとえば、NuGet ベースのリポジトリの場合、ソースの場所は と https://someNuGetUrl.com/api/v2似ています。

Type:Uri
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

入力

PSCredential

Uri

出力

Object

メモ

重要

2020 年 4 月時点で、PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 および 1.1 がサポートされなくなります。 TLS 1.2 以降を使用していない場合、PowerShell ギャラリーにアクセスしようとするとエラーが発生します。 次のコマンドを使用して、確実に TLS 1.2 を使用するようにします。

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

詳細については、PowerShell ブログのお知らせを参照してください。