Skip to content

Get GitHubRelease

Howard Wolosky edited this page Oct 5, 2020 · 1 revision

Get-GitHubRelease

SYNOPSIS

Retrieves information about a release or list of releases on GitHub.

SYNTAX

Elements (Default)

Get-GitHubRelease [-OwnerName <String>] [-RepositoryName <String>] [-AccessToken <String>] [<CommonParameters>]

Elements-Tag

Get-GitHubRelease [-OwnerName <String>] [-RepositoryName <String>] -Tag <String> [-AccessToken <String>]
 [<CommonParameters>]

Elements-Latest

Get-GitHubRelease [-OwnerName <String>] [-RepositoryName <String>] [-Latest] [-AccessToken <String>]
 [<CommonParameters>]

Elements-ReleaseId

Get-GitHubRelease [-OwnerName <String>] [-RepositoryName <String>] -Release <Int64> [-AccessToken <String>]
 [<CommonParameters>]

Uri-Tag

Get-GitHubRelease -Uri <String> -Tag <String> [-AccessToken <String>] [<CommonParameters>]

Uri-Latest

Get-GitHubRelease -Uri <String> [-Latest] [-AccessToken <String>] [<CommonParameters>]

Uri-ReleaseId

Get-GitHubRelease -Uri <String> -Release <Int64> [-AccessToken <String>] [<CommonParameters>]

Uri

Get-GitHubRelease -Uri <String> [-AccessToken <String>] [<CommonParameters>]

DESCRIPTION

Retrieves information about a release or list of releases on GitHub.

The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

EXAMPLES

EXAMPLE 1

Get-GitHubRelease

Gets all releases for the default configured owner/repository.

EXAMPLE 2

Get-GitHubRelease -Release 12345

Get a specific release for the default configured owner/repository

EXAMPLE 3

Get-GitHubRelease -OwnerName dotnet -RepositoryName core

Gets all releases from the dotnet\core repository.

EXAMPLE 4

Get-GitHubRelease -Uri https://github.com/microsoft/PowerShellForGitHub

Gets all releases from the microsoft/PowerShellForGitHub repository.

EXAMPLE 5

Get-GitHubRelease -OwnerName dotnet -RepositoryName core -Latest

Gets the latest release from the dotnet\core repository.

EXAMPLE 6

Get-GitHubRelease -Uri https://github.com/microsoft/PowerShellForGitHub -Tag 0.8.0

Gets the release tagged with 0.8.0 from the microsoft/PowerShellForGitHub repository.

PARAMETERS

-AccessToken

If provided, this will be used as the AccessToken for authentication with the REST Api. Otherwise, will attempt to use the configured value or will run unauthenticated.

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

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

-Latest

Retrieve only the latest release. This is an optional parameter which can limit the results to a single release.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: Elements-Latest, Uri-Latest
Aliases:

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

-OwnerName

Owner of the repository. If not supplied here, the DefaultOwnerName configuration property value will be used.

Type: System.String
Parameter Sets: Elements, Elements-Tag, Elements-Latest, Elements-ReleaseId
Aliases:

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

-Release

The ID of a specific release. This is an optional parameter which can limit the results to a single release.

Type: System.Int64
Parameter Sets: Elements-ReleaseId, Uri-ReleaseId
Aliases: ReleaseId

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

-RepositoryName

Name of the repository. If not supplied here, the DefaultRepositoryName configuration property value will be used.

Type: System.String
Parameter Sets: Elements, Elements-Tag, Elements-Latest, Elements-ReleaseId
Aliases:

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

-Tag

Retrieves a list of releases with the associated tag. This is an optional parameter which can filter the list of releases.

Type: System.String
Parameter Sets: Elements-Tag, Uri-Tag
Aliases:

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

-Uri

Uri for the repository. The OwnerName and RepositoryName will be extracted from here instead of needing to provide them individually.

Type: System.String
Parameter Sets: Uri-Tag, Uri-Latest, Uri-ReleaseId, Uri
Aliases: RepositoryUrl

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

CommonParameters

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

INPUTS

GitHub.Branch

GitHub.Content

GitHub.Event

GitHub.Issue

GitHub.IssueComment

GitHub.Label

GitHub.Milestone

GitHub.PullRequest

GitHub.Project

GitHub.ProjectCard

GitHub.ProjectColumn

GitHub.Reaction

GitHub.Release

GitHub.ReleaseAsset

GitHub.Repository

OUTPUTS

GitHub.Release

NOTES

Information about published releases are available to everyone. Only users with push access will receive listings for draft releases.

RELATED LINKS

PowerShellForGitHub

Docs

PowerShellForGitHub

Functions

Clone this wiki locally