Condividi tramite

Register-PSRepository

  • Riferimento
Modulo:
PowerShellGet

Registra un repository di PowerShell.

Sintassi

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

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 vengono registrati in un contesto a livello di sistema.

Questo è un cmdlet proxy per il Register-PSResourceRepository cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Register-PSResourceRepository.

Esempio

Esempio 1: Registrare un repository

$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

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

Il secondo comando ottiene repository registrati e visualizza i risultati.

Parametri

-Credential

Il cmdlet proxy ignora questo parametro perché non è supportato da Register-PSResourceRepository.

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

-Default

Registra PowerShell Gallery come repository predefinito.

Il cmdlet proxy trasforma il valore di questo parametro nel parametro PSGallery di Register-PSResourceRepository.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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, l'utente viene richiesto di confermare.

Il cmdlet proxy trasforma il valore di questo parametro nel parametro Trusted di Register-PSResourceRepository.

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

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

-PackageManagementProvider

Il cmdlet proxy ignora questo parametro perché non è supportato da Register-PSResourceRepository.

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

-Proxy

Il cmdlet proxy ignora questo parametro perché non è supportato da Register-PSResourceRepository.

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

-ProxyCredential

Il cmdlet proxy ignora questo parametro perché non è supportato da Register-PSResourceRepository.

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

-PublishLocation

Il cmdlet proxy ignora questo parametro perché non è supportato da Register-PSResourceRepository.

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

-ScriptPublishLocation

Il cmdlet proxy ignora questo parametro perché non è supportato da Register-PSResourceRepository.

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

-ScriptSourceLocation

Il cmdlet proxy ignora questo parametro perché non è supportato da Register-PSResourceRepository.

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

Il cmdlet proxy esegue il mapping di questo parametro al parametro Uri di Register-PSResourceRepository

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

Input

PSCredential

Uri

Output

Object

Note

La PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Per verificare di usare TLS 1.2, eseguire il comando seguente:

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