Set-PSResourceRepository
登録済みリポジトリの情報を設定します。
構文
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 |
入力
出力
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo
既定では、コマンドレットは出力を生成しません。 PassThru パラメーターを使用すると、コマンドレットは PSRepositoryInfo オブジェクトを返します。
関連リンク
PSResourceGet