Register-PSRepository

Registrerar en PowerShell-lagringsplats.

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

Cmdleten Register-PSRepository registrerar standardlagringsplatsen för PowerShell-moduler. När en lagringsplats har registrerats kan du referera till den från Find-Modulecmdletarna , Install-Moduleoch Publish-Module . Den registrerade lagringsplatsen blir standardlagringsplatsen i Find-Module och Install-Module.

Registrerade lagringsplatser är användarspecifika. De registreras inte 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 specifik 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/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

Det första kommandot registreras https://www.myget.org/F/powershellgetdemo/ som en lagringsplats för den aktuella användaren. När myNuGetSource har registrerats kan du uttryckligen referera till den 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.

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

-Default

Parametern används för att registrera PSGallery. Du behöver bara göra detta om du har tagit bort PSGallery-lagringsplatsen .

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 detta.

Du kan ange InstallationPolicy med cmdleten Set-PSRepository .

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 paketproviders och associerar den här lagringsplatsen med den första paketprovidern som anger att den kan hantera lagringsplatsen.

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

-Proxy

Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.

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

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.

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

-PublishLocation

Anger URI för publiceringsplatsen. För NuGet-baserade lagringsplatser liknar https://someNuGetUrl.com/api/v2/Packagestill exempel publiceringsplatsen .

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

-ScriptPublishLocation

Anger skriptets publiceringsplats.

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

-ScriptSourceLocation

Anger platsen för skriptkällan.

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

-SourceLocation

Anger URI för identifiering och installation av 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 .

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

Indata

PSCredential

Uri

Utdata

Object

Kommentarer

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 tillkännagivandet i PowerShell-bloggen.