Sdílet prostřednictvím

Set-PSResourceRepository

  • Reference
Modul:
Microsoft.PowerShell.PSResourceGet

Nastaví informace pro registrované úložiště.

Syntaxe

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

Description

Rutina Set-PSResourceRepository nastaví informace pro registrované úložiště.

Příklady

Příklad 1

V tomto příkladu je zaregistrovaný identifikátor URI úložiště PoshTestGallery . Rutina Set-PSResourceRepository slouží ke změně identifikátoru URI na místní cestu. Parametr PassThru umožňuje zobrazit změněné úložiště.

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

Příklad 2

Tento příklad změní hodnoty úložiště Priority (Priorita ) a Trusted (Důvěryhodné ).

Poznámka

Hodnotu URI výchozího úložiště PSGallery nelze změnit.

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

Příklad 3

Tento příklad používá parametr Repository ke změně hodnot pro více úložišť. Parametr přebírá pole zatřiďovacích tabulek. Každá zatřiďovací tabulka obsahuje informace o aktualizovaném úložišti.

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

Příklad 4

Tento příklad aktualizuje úložiště informacemi o přihlašovacích údajích, které se mají načíst z registrovaného trezoru Microsoft.PowerShell.SecretManagement . Musíte mít nainstalovaný modul Microsoft.PowerShell.SecretManagement a zaregistrovaný trezor obsahující uložený tajný kód. Formát tajného kódu musí odpovídat požadavkům úložiště.

$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

Určuje verzi rozhraní API používanou úložištěm. Platné hodnoty jsou:

  • v2 – používá rozhraní API NuGet v2.
  • v3 – používá rozhraní API NuGet v3.
  • local – použijte tuto možnost pro úložiště založená na systému souborů.
  • nugetServer – použijte tuto možnost pro úložiště založená na NuGet.Server.

Rutina Register-PSResourceRepository by měla automaticky rozpoznat verzi rozhraní API. Tento parametr umožňuje změnit verzi rozhraní API po registraci úložiště.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Přípustné hodnoty:unknown, v2, v3, local, nugetServer
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CredentialInfo

A PSCredentialInfo objekt, který obsahuje název trezoru a tajný klíč, který je uložen v úložišti Microsoft.PowerShell.SecretManagement .

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název úložiště, které se má upravit.

Poznámka

Hodnotu URI výchozího úložiště PSGallery nelze změnit.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Po zadání zobrazí úspěšně zaregistrované úložiště a jeho informace.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Priority

Určuje pořadí priorit úložiště. Platné hodnoty priority jsou v rozsahu od 0 do 100. Nižší hodnoty mají vyšší prioritu. Výchozí hodnota je 50.

Úložiště jsou seřazená podle priority a pak podle názvu. Při hledání prostředků ve více úložištích rutiny PSResourceGet prohledávají úložiště pomocí tohoto pořadí řazení a vrátí první nalezenou shodu.

Typ:Int32
Position:Named
Default value:50
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Repository

Určuje pole zatřiďovacích tabulek, které obsahují informace o úložišti. Tento parametr použijte k registraci více úložišť najednou. Každá zatřiďovací tabulka může mít klíče přidružené pouze k parametrům NameParameterSet.

Typ:Hashtable[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Trusted

Určuje, jestli má být úložiště důvěryhodné.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Uri

Určuje umístění úložiště, které se má zaregistrovat. Hodnota musí používat jedno z následujících schémat identifikátorů URI:

  • https://
  • http://
  • ftp://
  • file://
Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Ve výchozím nastavení rutina nevytváří žádný výstup. Při použití PassThru parametru vrátí rutina objekt PSRepositoryInfo .