Skip to content

Remove-GitHubAppInstallationRepositoryAccess

SYNOPSIS

Remove repository access to an organization installation.

SYNTAX

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

DESCRIPTION

Remove repository access to an organization installation.

EXAMPLES

EXAMPLE 1

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

Remove access to the repositories 'repo1' and 'repo2' for the installation with the ID '12345678' 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

-Repositories

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

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

Required: False
Position: 4
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: 5
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