Condividi tramite

Register-PSRepository

Modulo:
PowerShellGet Module

Registra un repository di PowerShell.

Sintassi

Default (Impostazione predefinita) 

Register-PSRepository
    -Name <String>
    -SourceLocation <Uri>
    [-PublishLocation <Uri>]
    [-InstallationPolicy <String>]
    [-PackageManagementProvider <String>]
    [<CommonParameters>]

Descrizione

Il cmdlet Register-PSRepository registra il repository predefinito per i moduli di PowerShell. Dopo aver registrato un repository, è possibile farvi riferimento dai cmdlet Find-Module, Install-Module e Publish-Module. Il repository registrato diventa il repository predefinito in Find-Module e Install-Module.

I repository registrati sono specifici dell'utente. Non sono registrati in un contesto a livello di sistema.

Ogni repository registrato è associato a un provider di pacchetti OneGet, specificato con il parametro PackageManagementProvider . Ogni provider OneGet è progettato per interagire con un tipo specifico di repository. Ad esempio, il provider NuGet è progettato per interagire con i repository basati su NuGet. Se non viene specificato un provider OneGet durante la registrazione, PowerShellGet tenta di trovare un provider OneGet in grado di gestire il percorso di origine specificato.

Esempio

Esempio 1: Registrare un repository

PS C:\> Register-PSRepository -Name "myNuGetSource" -SourceLocation "https://www.myget.org/F/powershellgetdemo/api/v2" -PublishLocation "https://www.myget.org/F/powershellgetdemo/api/v2/Packages" -InstallationPolicy Trusted
PS C:\> Get-PSRepository
Name                                     SourceLocation                                     OneGetProvider       InstallationPolicy
----                                     --------------                                     --------------       ------------------
PSGallery                                http://go.micro...                                 NuGet                Untrusted
myNuGetSource                            https://myget.c...                                 NuGet                Trusted

Il primo comando registra https://www.myget.org/F/powershellgetdemo/ come repository per l'utente corrente. Dopo aver registrato myNuGetSource, è possibile farvi riferimento in modo esplicito durante la ricerca, l'installazione e la pubblicazione di moduli. Poiché il parametro packageManagementProvider non è specificato, il repository non è associato in modo esplicito a un provider di pacchetti OneGet, quindi PowerShellGet esegue il polling dei provider di pacchetti disponibili e lo associa al provider NuGet.

Il secondo comando ottiene i repository registrati e visualizza i risultati.

Parametri

-InstallationPolicy

Specifica i criteri di installazione. I valori validi sono: Trusted, UnTrusted. Il valore predefinito è UnTrusted.

I criteri di installazione di un repository specificano il comportamento di PowerShell durante l'installazione da tale repository. Quando si installano moduli da un repository non attendibile, all'utente viene richiesto di confermare.

È possibile impostare il InstallationPolicy con il cmdlet Set-PSRepository.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Trusted, Untrusted
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome del repository da registrare. È possibile usare questo nome per specificare il repository nei cmdlet, ad esempio Find-Module e Install-Module.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PackageManagementProvider

Specifica un provider di pacchetti OneGet. Se non si specifica un valore per questo parametro, PowerShellGet esegue il polling dei provider di pacchetti disponibili e associa questo repository al primo provider di pacchetti che indica che può gestire il repository.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PublishLocation

Specifica l'URI del percorso di pubblicazione. Ad esempio, per i repository basati su NuGet, il percorso di pubblicazione è simile a http://someNuGetUrl.com/api/v2/Packages.

Proprietà dei parametri

Tipo:Uri
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SourceLocation

Specifica l'URI per l'individuazione e l'installazione di moduli da questo repository. Un URI può essere un feed di server NuGet (situazione più comune), HTTP, HTTPS, FTP o percorso file.

Ad esempio, per i repository basati su NuGet, il percorso di origine è simile a http://someNuGetUrl.com/api/v2.

Proprietà dei parametri

Tipo:Uri
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.