Set-PSResourceRepository

リファレンス

モジュール:: Microsoft.PowerShell.PSResourceGet

登録済みリポジトリの情報を設定します。

構文

Set-PSResourceRepository
   [-Name] <String>
   [-Uri <String>]
   [-Trusted]
   [-Priority <Int32>]
   [-ApiVersion <APIVersion>]
   [-CredentialInfo <PSCredentialInfo>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PSResourceRepository
   -Repository <Hashtable[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

コマンドレットは Set-PSResourceRepository 、登録済みリポジトリの情報を設定します。

例

例 1

この例では、PoshTestGallery リポジトリの Uri が登録されています。コマンドレットは Set-PSResourceRepository 、 Uri をローカルパスに変更するために使用されます。 PassThru パラメーターを使用すると、変更されたリポジトリを表示できます。

Get-PSResourceRepository -Name "PoshTestGallery"

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

Set-PSResourceRepository -Name "PoshTestGallery" -Uri "c:/code/testdir" -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  file:///c:/code/testdir                        False         50

例 2

次の使用例は、リポジトリの Priority 値と Trusted 値を変更します。

注意

既定の PSGallery リポジトリの Uri 値は変更できません。

Get-PSResourceRepository -Name "PSGallery"

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50

Set-PSResourceRepository -Name "PSGallery" -Priority 25 -Trusted -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         25

例 3

この例では、 Repository パラメーターを使用して、複数のリポジトリの値を変更します。パラメーターはハッシュテーブルの配列を受け取ります。各ハッシュテーブルには、更新されるリポジトリの情報が含まれています。

Get-PSResourceRepository

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

$arrayOfHashtables = @{Name = "PSGallery"; Trusted = $True},
                     @{Name = "PoshTestGallery"; Uri = "c:/code/testdir"}
Set-PSResourceRepository -Repository $arrayOfHashtables -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         50
PoshTestGallery  file:///c:/code/testdir                        False         50

例 4

この例では、登録済みの Microsoft.PowerShell.SecretManagement コンテナーから取得する資格情報を使用してリポジトリを更新します。 Microsoft.PowerShell.SecretManagement モジュールをインストールし、保存されているシークレットを含む登録済みコンテナーが必要です。シークレットの形式は、リポジトリの要件と一致している必要があります。

$parameters = @{
  Name = "PoshTestGallery"
  Uri = "c:/code/testdir"
  CredentialInfo = [Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Set-PSResourceRepository @parameters -PassThru |
    Select-Object * -ExpandProperty CredentialInfo

Name           : PoshTestGallery
Uri            : file:///c:/code/testdir
Trusted        : False
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

パラメーター

-ApiVersion

リポジトリで使用される API バージョンを指定します。有効な値は次のとおりです。

v2 - NuGet V2 API を使用します
v3 - NuGet V3 API を使用します
local - ファイルシステムベースのリポジトリに使用します
nugetServer - これは NuGet.Server ベースのリポジトリに使用します

コマンドレットは Register-PSResourceRepository API バージョンを自動的に検出する必要があります。このパラメーターを使用すると、リポジトリを登録した後で API のバージョンを変更できます。

型:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
指定可能な値:	unknown, v2, v3, local, nugetServer
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CredentialInfo

コンテナーの名前と、Microsoft.PowerShell.SecretManagement ストアに格納されているシークレットを含む PSCredentialInfo オブジェクト。

型:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

変更するリポジトリの名前を指定します。

注意

既定の PSGallery リポジトリの Uri 値は変更できません。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PassThru

指定すると、正常に登録されたリポジトリとその情報が表示されます。

型:	SwitchParameter
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Priority

リポジトリの優先度のランク付けを指定します。有効な優先度の値の範囲は 0 から 100 です。値が小さいと、優先順位のランク付けが高くなります。既定値は 50 です。

リポジトリは優先度順、名前順に並べ替えられます。複数のリポジトリ間でリソースを検索する場合、 PSResourceGet コマンドレットは、この並べ替え順序を使用してリポジトリを検索し、最初に見つかった一致を返します。

型:	Int32
配置:	Named
規定値:	50
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Repository

リポジトリ情報を含むハッシュテーブルの配列を指定します。複数のリポジトリを一度に登録するには、このパラメーターを使用します。各ハッシュテーブルには、 NameParameterSet のパラメーターに関連付けられているキーのみを含めることができます。

型:	Hashtable[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Trusted

リポジトリを信頼するかどうかを指定します。

型:	SwitchParameter
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Uri

登録するリポジトリの場所を指定します。値には、次のいずれかの URI スキーマを使用する必要があります。

https://
http://
ftp://
file://

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

出力

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

既定では、コマンドレットは出力を生成しません。 PassThru パラメーターを使用すると、コマンドレットは PSRepositoryInfo オブジェクトを返します。

Microsoft.PowerShell.SecretManagement

次の方法で共有

Set-PSResourceRepository

構文

説明

例

例 1

例 2

例 3

例 4

パラメーター

-ApiVersion

-Confirm

-CredentialInfo

-Name

-PassThru

-Priority

-Repository

-Trusted

-Uri

-WhatIf

入力

出力

その他のリソース

次の方法で共有

Set-PSResourceRepository

構文

説明

例

例 1

例 2

例 3

例 4

パラメーター

-ApiVersion

-Confirm

-CredentialInfo

-Name

-PassThru

-Priority

-Repository

-Trusted

-Uri

-WhatIf

入力

出力

関連リンク

その他のリソース