Register-PSRepository
Registrerar en PowerShell-lagringsplats.
Syntax
NameParameterSet (Standard)
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>]
Beskrivning
Cmdleten Register-PSRepository registrerar standardlagringsplatsen för PowerShell-moduler. När en lagringsplats har registrerats kan du referera till den Find-Modulefrån cmdletarna , Install-Moduleoch Publish-Module . Den registrerade lagringsplatsen blir standardlagringsplatsen i Find-Module och Install-Module.
Registrerade lagringsplatser är användarspecifika. De är inte registrerade i en systemomfattande kontext.
Varje registrerad lagringsplats är associerad med en OneGet-paketprovider, som anges med parametern PackageManagementProvider . Varje OneGet-provider är utformad för att interagera med en viss typ av lagringsplats. NuGet-providern är till exempel utformad för att interagera med NuGet-baserade lagringsplatser. Om en OneGet-provider inte anges under registreringen försöker PowerShellGet hitta en OneGet-provider som kan hantera den angivna källplatsen.
Exempel
Exempel 1: Registrera en lagringsplats
$parameters = @{
Name = "myNuGetSource"
SourceLocation = "https://www.myget.org/F/mypsrepository/api/v2"
PublishLocation = "https://www.myget.org/F/mypsrepository/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
Det första kommandot registreras https://www.myget.org/F/mypsrepository/ som en lagringsplats för den aktuella användaren. När myNuGetSource har registrerats kan du uttryckligen referera till det när du söker efter, installerar och publicerar moduler. Eftersom parametern PackageManagementProvider inte har angetts är lagringsplatsen inte uttryckligen associerad med en OneGet-paketprovider, så PowerShellGet avsöker tillgängliga paketproviders och associerar den med NuGet-providern.
Det andra kommandot hämtar registrerade lagringsplatser och visar resultatet.
Parametrar
-Credential
Anger autentiseringsuppgifter för ett konto som har behörighet att registrera en lagringsplats.
Egenskaper för parameter
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Default
Parametern används för att registrera PSGallery. Du behöver bara göra detta om du har tagit bort PSGallery-lagringsplatsen .
Egenskaper för parameter
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
PSGalleryParameterSet
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-InstallationPolicy
Anger installationsprincipen. Giltiga värden är: Betrodda, ej betrodda. Standardvärdet är Ej betrott.
En lagringsplatss installationsprincip anger PowerShell-beteende vid installation från den lagringsplatsen. När du installerar moduler från en ej betrodd lagringsplats uppmanas användaren att bekräfta.
Du kan ange InstallationPolicy med cmdleten Set-PSRepository .
Egenskaper för parameter
| Typ: | String |
| Standardvärde: | None |
| Godkända värden: | Trusted, Untrusted |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Name
Anger namnet på lagringsplatsen som ska registreras. Du kan använda det här namnet för att ange lagringsplatsen i cmdletar som Find-Module och Install-Module.
Egenskaper för parameter
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-PackageManagementProvider
Anger en OneGet-paketprovider. Om du inte anger något värde för den här parametern avsöker PowerShellGet tillgängliga paketleverantörer och associerar den här lagringsplatsen med den första paketleverantören som anger att den kan hantera lagringsplatsen.
Egenskaper för parameter
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Proxy
Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.
Egenskaper för parameter
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ProxyCredential
Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.
Egenskaper för parameter
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-PublishLocation
Anger URI för publiceringsplatsen för moduler. För NuGet-baserade lagringsplatser liknar https://someNuGetUrl.com/api/v2/packagetill exempel publiceringsplatsen .
Egenskaper för parameter
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ScriptPublishLocation
Anger URI för publiceringsplatsen för skript. För NuGet-baserade lagringsplatser liknar https://someNuGetUrl.com/api/v2/package/till exempel publiceringsplatsen .
Egenskaper för parameter
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ScriptSourceLocation
Anger URI:n för att identifiera och installera skript från den här lagringsplatsen. En URI kan vara en NuGet-serverfeed (den vanligaste situationen), HTTP, HTTPS, FTP eller filplats.
För NuGet-baserade lagringsplatser liknar källplatsen till https://someNuGetUrl.com/api/v2/items/psscriptexempel .
Egenskaper för parameter
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-SourceLocation
Anger URI:n för att identifiera och installera moduler från den här lagringsplatsen. En URI kan vara en NuGet-serverfeed (den vanligaste situationen), HTTP, HTTPS, FTP eller filplats.
För NuGet-baserade lagringsplatser liknar källplatsen till https://someNuGetUrl.com/api/v2exempel .
Egenskaper för parameter
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Ingångar
PSCredential
Uri
Utgångar
Object
Anteckningar
Viktigt!
Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Mer information finns i meddelande i PowerShell-bloggen.
