Register-PSRepository
Regisztrál egy PowerShell-adattárat.
Syntax
Default (Alapértelmezett)
Register-PSRepository
-Name <String>
-SourceLocation <Uri>
[-PublishLocation <Uri>]
[-InstallationPolicy <String>]
[-PackageManagementProvider <String>]
[<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, az Install-Module és a Publish-Module parancsmagokból. A regisztrált adattár lesz az alapértelmezett adattár Find-Module és 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
PS C:\> Register-PSRepository -Name "myNuGetSource" -SourceLocation "https://www.myget.org/F/powershellgetdemo/api/v2" -PublishLocation "https://www.myget.org/F/powershellgetdemo/api/v2/Packages" -InstallationPolicy Trusted
PS C:\> 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
-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 a Set-PSRepository parancsmaggal állítható be.
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 a Find-Module és az Install-Module.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| 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 |
-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
(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 |
-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ó http://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
(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 |
-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ó http://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
(All)
| 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 |
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.