Edit

Share via

Register-PackageSource

  • Reference
Module:
PackageManagement

Adds a package source for a specified package provider.

Syntax

Register-PackageSource
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [[-Name] <String>]
        [[-Location] <String>]
        [-Credential <PSCredential>]
        [-Trusted]
        [-Force]
        [-ForceBootstrap]
        [-WhatIf]
        [-Confirm]
        [-ProviderName <String>]
        [<CommonParameters>]
Register-PackageSource
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [[-Name] <String>]
        [[-Location] <String>]
        [-Credential <PSCredential>]
        [-Trusted]
        [-Force]
        [-ForceBootstrap]
        [-WhatIf]
        [-Confirm]
        [-ConfigFile <String>]
        [-SkipValidate]
        [<CommonParameters>]
Register-PackageSource
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [[-Name] <String>]
        [[-Location] <String>]
        [-Credential <PSCredential>]
        [-Trusted]
        [-Force]
        [-ForceBootstrap]
        [-WhatIf]
        [-Confirm]
        [-PackageManagementProvider <String>]
        [-PublishLocation <String>]
        [-ScriptSourceLocation <String>]
        [-ScriptPublishLocation <String>]
        [<CommonParameters>]

Description

The Register-PackageSource cmdlet adds a package source for a specified package provider. Package sources are always managed by a package provider. If the package provider cannot add or replace a package source, the provider generates an error message.

Examples

Example 1: Register a package source for the NuGet provider

This command registers a package source, a web-based location for the NuGet provider. By default, sources aren't trusted. You are prompted to confirm the source is trusted before packages are installed. To override the default, use the -Trusted parameter.

Register-PackageSource -Name MyNuGet -Location https://www.nuget.org/api/v2 -ProviderName NuGet

Name          ProviderName     IsTrusted  Location
----          ------------     ---------  --------
MyNuGet       NuGet            False      https://www.nuget.org/api/v2

Parameters

-ConfigFile

Specifies a configuration file.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifies a user account that has permission to access the authenticated location.

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

-Force

Forces the command to run without asking for user confirmation.

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

-ForceBootstrap

Indicates that this cmdlet automatically installs the package provider.

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

-Location

Specifies the package source location.

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

-Name

Specifies the name of the package source to register.

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

-PackageManagementProvider

Specifies the Package Management provider.

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

-ProviderName

Specifies the package provider's name.

Type:String
Aliases:Provider
Accepted values:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Proxy

Specifies a proxy server for the request, rather than a direct connection to the internet resource.

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

-ProxyCredential

Specifies a user account that has permission to use the proxy server that is specified by the Proxy parameter.

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

-PublishLocation

Specifies the publish location.

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

-ScriptPublishLocation

Specifies the script publish location.

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

-ScriptSourceLocation

Specifies the script source location.

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

-SkipValidate

Switch that skips validating the credentials of a package source.

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

-Trusted

Indicates that the package source is trusted.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notes

Important

As of April 2020, the PowerShell Gallery no longer supports Transport Layer Security (TLS) versions 1.0 and 1.1. If you are not using TLS 1.2 or higher, you will receive an error when trying to access the PowerShell Gallery. Use the following command to ensure you are using TLS 1.2:

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

For more information, see the announcement in the PowerShell blog.