< Back

Remove-JiraGroupMember

Thu Jan 16, 2020 8:11 am

NAME Remove-JiraGroupMember



SYNOPSIS

Removes a user from a JIRA group





SYNTAX

Remove-JiraGroupMember [-Group] <Object[]> [-User] <Object[]> [[-Credential] <PSCredential>] [-PassThru] [-Force]

[-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

This function removes a JIRA user from a JIRA group.





PARAMETERS

-Group <Object[]>

Group Object or ID from which to remove the user(s).



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-User <Object[]>

Username or user object obtained from Get-JiraUser



Required? true

Position? 2

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Credential <PSCredential>

Credentials to use to connect to JIRA.

If not specified, this function will use anonymous access.



Required? false

Position? 3

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-PassThru [<SwitchParameter>]

Whether output should be provided after invoking this function



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Force [<SwitchParameter>]

Suppress user confirmation.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

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



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

[JiraPS.Group[]]

Group(s) from which users should be removed



[JiraPS.User[]]

User(s) which to remove





OUTPUTS

[JiraPS.Group]

If the `-PassThru` parameter is provided, this function will provide a reference to the JIRA group modified.

Otherwise, this function does not provide output.





NOTES





This REST method is still marked Experimental in JIRA's REST API. That means that there is a high probability

this will break in future versions of JIRA. The function will need to be re-written at that time.



This function requires either the `-Credential` parameter to be passed or a persistent JIRA session. See

`New-JiraSession` for more details. If neither are supplied, this function will run with anonymous access to

JIRA.



-------------------------- EXAMPLE 1 --------------------------



Remove-JiraGroupMember -Group testUsers -User jsmith



This example removes the user jsmith from the group testUsers.

-------------------------- EXAMPLE 2 --------------------------



Get-JiraGroup 'Project Admins' | Remove-JiraGroupMember -User jsmith



This example illustrates the use of the pipeline to remove jsmith from the "Project Admins" group in JIRA.



RELATED LINKS

Online Version: https://atlassianps.org/docs/JiraPS/com ... oupMember/

Add-JiraGroupMember

Get-JiraGroup

Get-JiraGroupMember

Get-JiraUser

New-JiraGroup