Dela via

Register-PSRepository

  • Referens
Modul:
PowerShellGet

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 cmdletarna Find-Module, 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/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 registrerar 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 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 söker efter tillgängliga paketleverantörer 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.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Default

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Godkända värden:Trusted, Untrusted
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Proxy

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

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ProxyCredential

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

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PublishLocation

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

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ScriptPublishLocation

Anger publiceringsplatsen för skriptet.

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ScriptSourceLocation

Anger platsen för skriptkällan.

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 exempel https://someNuGetUrl.com/api/v2.

Typ:Uri
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSCredential

Uri

Utdata

Object