Register-PSRepository

  • Referenz
Modul:
PowerShellGet

Registriert ein PowerShell-Repository.

Syntax

Register-PSRepository
        [-Name] <String>
        [-SourceLocation] <Uri>
        [-PublishLocation <Uri>]
        [-ScriptSourceLocation <Uri>]
        [-ScriptPublishLocation <Uri>]
        [-Credential <PSCredential>]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [-PackageManagementProvider <String>]
        [<CommonParameters>]
Register-PSRepository
        [-Default]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [<CommonParameters>]

Beschreibung

Das Register-PSRepository Cmdlet registriert das Standardrepository für PowerShell-Module. Nachdem ein Repository registriert wurde, können Sie über die Find-ModuleCmdlets , Install-Moduleund Publish-Module darauf verweisen. Das registrierte Repository wird zum Standardrepository in Find-Module und Install-Module.

Registrierte Repositorys sind benutzerspezifisch. Sie sind nicht in einem systemweiten Kontext registriert.

Dies ist ein Proxy-Cmdlet für das Register-PSResourceRepository Cmdlet im Microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Register-PSResourceRepository.

Beispiele

Beispiel 1: Registrieren eines Repositorys

$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

Der erste Befehl wird https://www.myget.org/F/powershellgetdemo/ als Repository für den aktuellen Benutzer registriert. Nachdem myNuGetSource registriert wurde, können Sie beim Suchen, Installieren und Veröffentlichen von Modulen explizit darauf verweisen. Da der Parameter PackageManagementProvider nicht angegeben ist, ist das Repository nicht explizit einem OneGet-Paketanbieter zugeordnet, sodass PowerShellGet verfügbare Paketanbieter abruft und dem NuGet-Anbieter ordnet.

Der zweite Befehl ruft registrierte Repositorys ab und zeigt die Ergebnisse an.

Parameter

-Credential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er von nicht unterstützt wird Register-PSResourceRepository.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Default

Registriert PowerShell-Katalog als Standardrepository.

Das Proxy-Cmdlet transformiert den Wert dieses Parameters in den PSGallery-Parameter von Register-PSResourceRepository.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InstallationPolicy

Gibt die Installationsrichtlinie an. Gültige Werte sind: Vertrauenswürdig, Nicht vertrauenswürdig. Der Standardwert ist Nicht vertrauenswürdig.

Die Installationsrichtlinie eines Repositorys gibt das PowerShell-Verhalten bei der Installation aus diesem Repository an. Beim Installieren von Modulen aus einem nicht vertrauenswürdigen Repository wird der Benutzer zur Bestätigung aufgefordert.

Das Proxy-Cmdlet transformiert den Wert dieses Parameters in den Trusted-Parameter von Register-PSResourceRepository.

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen des zu registrierenden Repositorys an. Sie können diesen Namen verwenden, um das Repository in Cmdlets wie Find-Module und Install-Moduleanzugeben.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

Das Proxy-Cmdlet ignoriert diesen Parameter, da er von nicht unterstützt wird Register-PSResourceRepository.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Das Proxy-Cmdlet ignoriert diesen Parameter, da er von nicht unterstützt wird Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er von nicht unterstützt wird Register-PSResourceRepository.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublishLocation

Das Proxy-Cmdlet ignoriert diesen Parameter, da er von nicht unterstützt wird Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptPublishLocation

Das Proxy-Cmdlet ignoriert diesen Parameter, da er von nicht unterstützt wird Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptSourceLocation

Das Proxy-Cmdlet ignoriert diesen Parameter, da er von nicht unterstützt wird Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceLocation

Gibt den URI zum Ermitteln und Installieren von Modulen aus diesem Repository an. Ein URI kann ein NuGet-Serverfeed (häufigste Situation), HTTP, HTTPS, FTP oder Dateispeicherort sein.

Für NuGet-basierte Repositorys ähnelt https://someNuGetUrl.com/api/v2der Quellspeicherort beispielsweise .

Das Proxy-Cmdlet ordnet diesen Parameter dem URI-Parameter von zu Register-PSResourceRepository

Type:Uri
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSCredential

Uri

Ausgaben

Object

Hinweise

Die PowerShell-Katalog die TLS-Versionen 1.0 und 1.1 (Transport Layer Security) nicht mehr unterstützt. Sie müssen TLS 1.2 oder höher verwenden. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12