Register-PSRepository
Regisztrál egy PowerShell-adattárat.
Syntax
NameParameterSet (Alapértelmezett)
Register-PSRepository
[-Name] <String>
[-SourceLocation] <Uri>
[-PublishLocation <Uri>]
[-ScriptSourceLocation <Uri>]
[-ScriptPublishLocation <Uri>]
[-Credential <PSCredential>]
[-InstallationPolicy <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-PackageManagementProvider <String>]
[<CommonParameters>]
PSGalleryParameterSet
Register-PSRepository
[-Default]
[-InstallationPolicy <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[<CommonParameters>]
Description
A Register-PSRepository parancsmag regisztrálja a PowerShell-modulok alapértelmezett adattárát. Az adattár regisztrálása után hivatkozhat rá a , Find-Moduleés Install-Module a Publish-Moduleparancsmagokból. A regisztrált tárház lesz az alapértelmezett adattár az Find-Module and Install-Module.
A regisztrált adattárak felhasználóspecifikusak. Nincsenek rendszerszintű környezetben regisztrálva.
Minden regisztrált adattár egy OneGet-csomagszolgáltatóhoz van társítva, amely a PackageManagementProvider paraméterrel van megadva. Minden Egyes OneGet-szolgáltató egy adott típusú adattár használatához lett kialakítva. A NuGet-szolgáltatót például úgy tervezték, hogy nuGet-alapú adattárakat használjon. Ha a regisztráció során nincs megadva OneGet-szolgáltató, a PowerShellGet megpróbál megkeresni egy OneGet-szolgáltatót, amely képes kezelni a megadott forráshelyet.
Példák
1. példa: Adattár regisztrálása
$parameters = @{
Name = "myNuGetSource"
SourceLocation = "https://www.myget.org/F/powershellgetdemo/api/v2"
PublishLocation = "https://www.myget.org/F/powershellgetdemo/api/v2/Packages"
InstallationPolicy = 'Trusted'
}
Register-PSRepository @parameters
Get-PSRepository
Name SourceLocation OneGetProvider InstallationPolicy
---- -------------- -------------- ------------------
PSGallery http://go.micro... NuGet Untrusted
myNuGetSource https://myget.c... NuGet Trusted
Az első parancs a https://www.myget.org/F/powershellgetdemo/ regisztrálja az aktuális felhasználó adattáraként. A myNuGetSource regisztrálása után kifejezetten hivatkozhat rá modulok keresésekor, telepítésekor és közzétételekor. Mivel a PackageManagementProvider paraméter nincs megadva, az adattár nincs explicit módon társítva egy OneGet-csomagszolgáltatóval, ezért a PowerShellGet lekérdezi az elérhető csomagszolgáltatókat, és társítja azt a NuGet-szolgáltatóhoz.
A második parancs megkapja a regisztrált adattárakat, és megjeleníti az eredményeket.
Paraméterek
-Credential
Olyan fiók hitelesítő adatait adja meg, amelyek jogosultak az adattárak regisztrálására.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Default
A paraméter a PSGallery regisztrálására szolgál. Ezt csak akkor kell megtennie, ha eltávolította a PSGallery-adattárat .
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
PSGalleryParameterSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InstallationPolicy
Megadja a telepítési szabályzatot. Az érvényes értékek a következők: Megbízható, Nem megbízható. Az alapértelmezett érték nem megbízható.
Az adattár telepítési szabályzata a PowerShell viselkedését határozza meg az adott adattárból való telepítéskor. Ha nem megbízható adattárból telepít modulokat, a rendszer megerősítést kér a felhasználótól.
A InstallationPolicy parancsmaggal Set-PSRepository beállítható.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Trusted, Untrusted |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Megadja a regisztrálandó adattár nevét. Ezzel a névvel megadhatja az adattárat olyan parancsmagokban, mint például Find-Module a és Install-Modulea .
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-PackageManagementProvider
Egy OneGet-csomagszolgáltatót határoz meg. Ha nem ad meg értéket ehhez a paraméterhez, a PowerShellGet lekérdezi az elérhető csomagszolgáltatókat, és társítja ezt az adattárat az első csomagszolgáltatóhoz, amely azt jelzi, hogy képes kezelni az adattárat.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Proxy
Proxykiszolgálót ad meg a kéréshez, ahelyett, hogy közvetlenül csatlakozik az interneterőforráshoz.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ProxyCredential
Olyan felhasználói fiókot ad meg, amely jogosult a proxyparaméter által megadott proxykiszolgáló használatára.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PublishLocation
Megadja a közzétételi hely URI-ját. A NuGet-alapú adattárak esetében például a közzététel helye hasonló https://someNuGetUrl.com/api/v2/Packages.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ScriptPublishLocation
Megadja a szkript közzétételi helyét.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ScriptSourceLocation
Megadja a szkript forráshelyét.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-SourceLocation
Megadja az adattárból származó modulok felderítéséhez és telepítéséhez szükséges URI-t. Az URI lehet NuGet-kiszolgálócsatorna (a leggyakoribb helyzet), HTTP, HTTPS, FTP vagy fájlhely.
A NuGet-alapú adattárak esetében például a forráshely hasonló https://someNuGetUrl.com/api/v2.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSCredential
Uri
Kimenetek
Object
Jegyzetek
Fontos
2020 áprilisától a PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2 vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-gyűjtemény elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
További információ: közlemény a PowerShell blogjában.