Udostępnij za pośrednictwem

Set-PSResourceRepository

  • Odwołanie
Moduł:
Microsoft.PowerShell.PSResourceGet

Ustawia informacje dotyczące zarejestrowanego repozytorium.

Składnia

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>]

Opis

Polecenie cmdlet Set-PSResourceRepository ustawia informacje dotyczące zarejestrowanego repozytorium.

Przykłady

Przykład 1

W tym przykładzie zarejestrowano identyfikatora URI dla repozytorium PoshTestGallery. Polecenie cmdlet Set-PSResourceRepository służy do zmiany identyfikatora URI na ścieżkę lokalną. Parametr PassThru umożliwia wyświetlenie zmienionego repozytorium.

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

Przykład 2

W tym przykładzie zmiany wartości Priority i Trusted repozytorium.

Nuta

Nie można zmienić wartości Uri domyślnego repozytorium PSGallery.

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

Przykład 3

W tym przykładzie użyto parametru Repository w celu zmiany wartości dla wielu repozytoriów. Parametr przyjmuje tablicę tabel skrótów. Każda tabela skrótów zawiera informacje o aktualizowanym repozytorium.

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

Przykład 4

W tym przykładzie zaktualizowano repozytorium z informacjami o poświadczeniach, które mają zostać pobrane z zarejestrowanego magazynu Microsoft.PowerShell.SecretManagement. Musisz mieć zainstalowany moduł Microsoft.PowerShell.SecretManagement i mieć zarejestrowany magazyn zawierający przechowywany wpis tajny. Format wpisu tajnego musi być zgodny z wymaganiami repozytorium.

$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     :

Parametry

-ApiVersion

Określa wersję interfejsu API używaną przez repozytorium. Prawidłowe wartości to:

  • v2 — używa interfejsu API NuGet w wersji 2
  • v3 — używa interfejsu API NuGet w wersji 3
  • ContainerRegistry — używane w usłudze Azure Container Registry
  • local — użyj go w przypadku repozytoriów opartych na systemie plików
  • nugetServer — użyj go w przypadku repozytoriów opartych na serwerze NuGet.Server

Polecenie cmdlet Register-PSResourceRepository powinno automatycznie wykryć wersję interfejsu API. Ten parametr umożliwia zmianę wersji interfejsu API po zarejestrowaniu repozytorium.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Dopuszczalne wartości:V2, V3, Local, NugetServer, ContainerRegistry
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CredentialInfo

Obiekt PSCredentialInfo zawierający nazwę magazynu i wpis tajny przechowywany w magazynie Microsoft.PowerShell.SecretManagement store.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę repozytorium do zmodyfikowania.

Nuta

Nie można zmienić wartości Uri domyślnego repozytorium PSGallery.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PassThru

Po określeniu zostanie wyświetlone pomyślnie zarejestrowane repozytorium i jego informacje.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Priority

Określa klasyfikację priorytetu repozytorium. Prawidłowe wartości priorytetu wahają się od 0 do 100. Niższe wartości mają wyższy priorytet klasyfikacji. Wartość domyślna to 50.

Repozytoria są sortowane według priorytetu, a następnie według nazwy. Podczas wyszukiwania zasobów w wielu repozytoriach polecenia cmdlet PSResourceGet przeszukiwają repozytoria przy użyciu tej kolejności sortowania i zwracają pierwsze znalezione dopasowanie.

Typ:Int32
Position:Named
Domyślna wartość:50
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Repository

Określa tablicę tabel skrótów, które zawierają informacje o repozytorium. Użyj tego parametru, aby zarejestrować wiele repozytoriów jednocześnie. Każda tabela skrótów może mieć tylko klucze skojarzone z parametrami NameParameterSet.

Typ:Hashtable[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Trusted

Określa, czy repozytorium powinno być zaufane.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Uri

Określa lokalizację repozytorium do zarejestrowania. Wartość musi używać jednego z następujących schematów identyfikatora URI:

  • https://
  • http://
  • ftp://
  • file://
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Dane wyjściowe

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Domyślnie polecenie cmdlet nie generuje żadnych danych wyjściowych. Jeśli używasz parametru PassThru, polecenie cmdlet zwraca obiekt PSRepositoryInfo.