次の方法で共有


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