Edit

Share via

Set-PackageSource

  • Reference
Module:
PackageManagement

Replaces a package source for a specified package provider.

Syntax

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

Description

The Set-PackageSource replaces a package source for a specified package provider. Package sources are always managed by a package provider.

Examples

Example 1: Change a package source

This command changes the existing name of a package source. The source is set to Trusted, which eliminates prompts to verify the source when packages are installed.

PS C:\> Set-PackageSource -Name MyNuget -NewName NewNuGet -Trusted -ProviderName NuGet

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 install package providers.

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 Set-PackageSource forces PackageManagement to automatically install the package provider.

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

-InputObject

Specifies a package source ID object that represents the package that you want to change. Package source IDs are part of the results of the Get-PackageSource cmdlet.

Type:Microsoft.PackageManagement.Packaging.PackageSource
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

Specifies the current package source location. The value can be a URI, a file path, or any other destination format supported by the package provider.

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

-Name

Specifies a package source's name.

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

-NewLocation

Specifies the new location for a package source. The value can be a URI, a file path, or any other destination format supported by the package provider.

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

-NewName

Specifies the new name you assign to a package source.

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

-PackageManagementProvider

Specifies a package management provider.

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

-ProviderName

Specifies a provider 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 connecting directly 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 source is a trusted package provider. Trusted sources don't prompt for verification to install packages.

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

Inputs

None

You can't pipe objects to this cmdlet.

Outputs

None

This cmdlet returns no output.

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.