Connect-GitHubApp¶
SYNOPSIS¶
Connects to GitHub as a installation using a GitHub App.
SYNTAX¶
__AllParameterSets (Default)¶
Connect-GitHubApp [-PassThru] [-Default] [-Context <Object>] [-ProgressAction <ActionPreference>]
[<CommonParameters>]
User¶
Connect-GitHubApp -User <String> [-PassThru] [-Default] [-Context <Object>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
Organization¶
Connect-GitHubApp -Organization <String> [-PassThru] [-Default] [-Context <Object>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
Enterprise¶
Connect-GitHubApp -Enterprise <String> [-PassThru] [-Default] [-Context <Object>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION¶
Connects to GitHub using a GitHub App to generate installation access tokens and create contexts for targets.
Available target types: - User - Organization - Enterprise
EXAMPLES¶
EXAMPLE 1¶
Connect-GitHubApp
Connects to GitHub as all available targets using the logged in GitHub App.
EXAMPLE 2¶
Connect-GitHubApp -User 'octocat'
Connects to GitHub as the user 'octocat' using the logged in GitHub App.
EXAMPLE 3¶
Connect-GitHubApp -Organization 'psmodule' -Default
Connects to GitHub as the organization 'psmodule' using the logged in GitHub App and sets it as the default context.
EXAMPLE 4¶
Connect-GitHubApp -Enterprise 'msx'
Connects to GitHub as the enterprise 'msx' using the logged in GitHub App.
PARAMETERS¶
-User¶
The user account to connect to.
Type: String
Parameter Sets: User
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Organization¶
The organization to connect to.
Type: String
Parameter Sets: Organization
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Enterprise¶
The enterprise to connect to.
Type: String
Parameter Sets: Enterprise
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru¶
Passes the context object to the pipeline.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Default¶
Set as the default context.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Context¶
The context to run the command in. Used to get the details for the API call. Can be either a string or a GitHubContext object.
Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: (Get-GitHubContext)
Accept pipeline input: False
Accept wildcard characters: False
-ProgressAction¶
{{ Fill ProgressAction Description }}
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
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¶
OUTPUTS¶
System.Void¶
NOTES¶
Authenticating to the REST API