Back to Winget Cli

Add-WinGetSource

src/PowerShell/Help/Microsoft.WinGet.Client/Add-WinGetSource.md

1.28.2402.9 KB
Original Source

Add-WinGetSource

SYNOPSIS

Adds a new source.

SYNTAX

Add-WinGetSource -Name <String> -Argument <String> [-Type <String>] [-TrustLevel {Default | None | Trusted}] [-Explicit] [<CommonParameters>]

DESCRIPTION

Adds a new source. A source provides the data for you to discover and install packages. Only add a new source if you trust it as a secure location. This command must be executed with administrator permissions.

EXAMPLES

Example 1: Add new REST source named mysource

powershell
Add-WinGetSource -Name mysource -Argument https://contoso.com/ -Type Microsoft.Rest

This example adds a new REST source to WinGet named mysource with the root URL https://contoso.com/. The source must respond with the WinGet REST source API.

PARAMETERS

-Argument

The URL or UNC of either a pre-indexed WinGet source or a WinGet REST source API.

yaml
Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Name

The name used to identify the WinGet source.

yaml
Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Explicit

Excludes a source from discovery unless specified.

yaml
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-TrustLevel

Specify the trust level of the WinGet source. The parameter accepts the following values:

  • None
  • Trusted
yaml
Type: Microsoft.WinGet.Client.PSObjects.PSSourceTrustLevel
Parameter Sets: (All)
Aliases:
Accepted values: None, Trusted

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Type

The type of the WinGet source. Most sources are Microsoft.Rest. The WinGet community repository is Microsoft.PreIndexed.Package.

yaml
Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

System.String

OUTPUTS

System.Object

NOTES

Remove-WinGetSource

Reset-WinGetSource