Condividi tramite

Register-PSRepository

Modulo:
PowerShellGet Module

Registra un repository di PowerShell.

Sintassi

NameParameterSet (Impostazione predefinita) 

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

PSGalleryParameterSet 

Register-PSRepository
    [-Default]
    [-InstallationPolicy <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [<CommonParameters>]

Descrizione

Il Register-PSRepository cmdlet registra il repository predefinito per i moduli di PowerShell. Dopo la registrazione di un repository, è possibile farvi riferimento dai Find-Modulecmdlet , Install-Modulee 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

$parameters = @{
  Name = "myNuGetSource"
  SourceLocation = "https://www.myget.org/F/mypsrepository/api/v2"
  PublishLocation = "https://www.myget.org/F/mypsrepository/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

Il primo comando registra https://www.myget.org/F/mypsrepository/ 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

-Credential

Specifica le credenziali di un account con diritti per registrare un repository.

Proprietà dei parametri

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

Set di parametri

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

-Default

Il parametro viene usato per registrare PSGallery. Questa operazione deve essere eseguita solo se è stato rimosso il repository PSGallery .

Proprietà dei parametri

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

Set di parametri

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

-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 InstallationPolicy con il Set-PSRepository cmdlet .

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, Find-Module ad esempio e Install-Module.

Proprietà dei parametri

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

Set di parametri

NameParameterSet
Posizione:0
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

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

-Proxy

Specifica un server proxy per la richiesta, anziché connettersi direttamente alla risorsa Internet.

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à:True
Valore dagli argomenti rimanenti:False

-ProxyCredential

Specifica un account utente autorizzato a usare il server proxy specificato dal parametro Proxy .

Proprietà dei parametri

Tipo:PSCredential
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à:True
Valore dagli argomenti rimanenti:False

-PublishLocation

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

Proprietà dei parametri

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

Set di parametri

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

-ScriptPublishLocation

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

Proprietà dei parametri

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

Set di parametri

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

-ScriptSourceLocation

Specifica l'URI per l'individuazione e l'installazione di script 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 https://someNuGetUrl.com/api/v2/items/psscript.

Proprietà dei parametri

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

Set di parametri

NameParameterSet
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 https://someNuGetUrl.com/api/v2.

Proprietà dei parametri

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

Set di parametri

NameParameterSet
Posizione:1
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.

Input

PSCredential

Uri

Output

Object

Note

Importante

A partire da aprile 2020, PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di Transport Layer Security (TLS). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si prova ad accedere a PowerShell Gallery. Usare il comando seguente per assicurarsi di usare TLS 1.2:

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

Per altre informazioni, vedere l'annuncio nel blog di PowerShell.