Register-PSRepository

  • Referentie
Module:
PowerShellGet

Registreert een PowerShell-opslagplaats.

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>]

Description

De Register-PSRepository cmdlet registreert de standaardopslagplaats voor PowerShell-modules. Nadat een opslagplaats is geregistreerd, kunt u ernaar verwijzen vanuit de Find-Modulecmdlets , Install-Moduleen Publish-Module . De geregistreerde opslagplaats wordt de standaardopslagplaats in Find-Module en Install-Module.

Geregistreerde opslagplaatsen zijn gebruikersspecifiek. Ze worden niet geregistreerd in een systeembrede context.

Dit is een proxy-cmdlet voor de Register-PSResourceRepository cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Register-PSResourceRepository voor meer informatie.

Voorbeelden

Voorbeeld 1: Een opslagplaats registreren

$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

De eerste opdracht wordt geregistreerd https://www.myget.org/F/powershellgetdemo/ als een opslagplaats voor de huidige gebruiker. Nadat myNuGetSource is geregistreerd, kunt u er expliciet naar verwijzen wanneer u modules zoekt, installeert en publiceert. Omdat de parameter PackageManagementProvider niet is opgegeven, is de opslagplaats niet expliciet gekoppeld aan een OneGet-pakketprovider, dus PowerShellGet peilt beschikbare pakketproviders en koppelt deze aan de NuGet-provider.

Met de tweede opdracht worden geregistreerde opslagplaatsen opgehaald en worden de resultaten weergegeven.

Parameters

-Credential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Register-PSResourceRepository.

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

-Default

Registreert PowerShell Gallery als de standaardopslagplaats.

De proxy-cmdlet transformeert de waarde van deze parameter naar de PSGallery-parameter van Register-PSResourceRepository.

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

-InstallationPolicy

Hiermee geeft u het installatiebeleid op. Geldige waarden zijn: Vertrouwd, Niet-vertrouwd. De standaardwaarde is Niet-vertrouwd.

Het installatiebeleid van een opslagplaats bepaalt het Gedrag van PowerShell bij het installeren vanuit die opslagplaats. Wanneer u modules installeert vanuit een niet-vertrouwde opslagplaats, wordt de gebruiker om bevestiging gevraagd.

De proxy-cmdlet transformeert de waarde van deze parameter naar de vertrouwde parameter van Register-PSResourceRepository.

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

-Name

Hiermee geeft u de naam van de opslagplaats te registreren. U kunt deze naam gebruiken om de opslagplaats op te geven in cmdlets zoals Find-Module en Install-Module.

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

-PackageManagementProvider

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Register-PSResourceRepository.

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

-Proxy

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Register-PSResourceRepository.

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

-ProxyCredential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Register-PSResourceRepository.

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

-PublishLocation

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Register-PSResourceRepository.

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

-ScriptPublishLocation

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Register-PSResourceRepository.

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

-ScriptSourceLocation

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Register-PSResourceRepository.

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

-SourceLocation

Hiermee geeft u de URI voor het detecteren en installeren van modules uit deze opslagplaats. Een URI kan een NuGet-serverfeed (meest voorkomende situatie), HTTP, HTTPS, FTP of bestandslocatie zijn.

Voor opslagplaatsen op basis van NuGet is de bronlocatie bijvoorbeeld vergelijkbaar met https://someNuGetUrl.com/api/v2.

De proxy-cmdlet wijst deze parameter toe aan de URI-parameter van Register-PSResourceRepository

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

Invoerwaarden

PSCredential

Uri

Uitvoerwaarden

Object

Notities

De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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