Skip to content

Update-GitHubAppInstallationRepositoryAccess

SYNOPSIS

Update the installation repository access between all repositories and selected repositories.

SYNTAX

Update-GitHubAppInstallationRepositoryAccess [-Enterprise] <String> [-Organization] <String> [-ID] <Int32>
 [-RepositorySelection] <String> [[-Repositories] <String[]>] [[-Context] <Object>]
 [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Update repository access for a GitHub App installation between all repositories and selected repositories.

EXAMPLES

EXAMPLE 1

Update-GitHubAppInstallationRepositoryAccess -Enterprise 'msx' -Organization 'PSModule' -InstallationID 12345678 -RepositorySelection 'all'

Update the repository access for the GitHub App installation with the ID '12345678' to all repositories on the organization 'PSModule' in the enterprise 'msx'.

EXAMPLE 2

$params = @{
    Enterprise          = 'msx'
    Organization        = 'PSModule'
    InstallationID      = 12345678
    RepositorySelection = 'selected'
    Repositories        = 'repo1', 'repo2'
}
Update-GitHubAppInstallationRepositoryAccess @params

Update the repository access for the GitHub App installation with the ID '12345678' to the repositories 'repo1' and 'repo2' on the organization 'PSModule' in the enterprise 'msx'.

PARAMETERS

-Enterprise

The enterprise slug or ID.

Type: String
Parameter Sets: (All)
Aliases:

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

-Organization

The organization name. The name is not case sensitive.

Type: String
Parameter Sets: (All)
Aliases:

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

-ID

The unique identifier of the installation. Example: '12345678'

Type: Int32
Parameter Sets: (All)
Aliases: installation_id, InstallationID

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

-RepositorySelection

The repository selection for the GitHub App. Can be one of: - all - all repositories that the authenticated GitHub App installation can access. - selected - select specific repositories.

Type: String
Parameter Sets: (All)
Aliases:

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

-Repositories

The names of the repositories to which the installation will be granted access.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: @()
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: 6
Default value: (Get-GitHubContext)
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
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

NOTES