Set-PSResourceRepository
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
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 .