Set-GoogleDirectoryGroupMemberRole

NAME Set-GoogleDirectoryGroupMemberRole



SYNOPSIS

Sets the role of a group member.





SYNTAX

Set-GoogleDirectoryGroupMemberRole -GroupKey <String> -Role <String> -UserId <String> -BearerToken <String>

[-UseCompression] [-PassThru] [<CommonParameters>]



Set-GoogleDirectoryGroupMemberRole -GroupKey <String> -Role <String> -UserId <String> [-ProfileLocation <String>]

[-Persist] [-UseCompression] [-PassThru] [<CommonParameters>]





DESCRIPTION

This cmdlet sets the role of an existing GSuite group member.





PARAMETERS

-GroupKey <String>

The unique Id of the group.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Role <String>

The role the member will be set to, either MEMBER, OWNER, or MANAGER.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-UserId <String>

The Id of the user whose role will be modified.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-BearerToken <String>

The bearer token to use to authenticate the request.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ProfileLocation <String>

The location where stored credentials are located. If this is not specified, the default location will be used.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Persist [<SwitchParameter>]

Indicates that the newly retrieved token(s) or refreshed token and associated client data like client secret

are persisted to disk.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-UseCompression [<SwitchParameter>]

If specified, the returned data is compressed using gzip.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-PassThru [<SwitchParameter>]

If specified, the member's membership information is passed to the pipeline.



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

None





OUTPUTS

None or System.Collections.Hashtable



This is an example of the member's membership information output:

{

"kind": "directory#member",

"id": "group member's unique ID",

"email": "liz@example.com",

"role": "MEMBER",

"type": "GROUP"

}





NOTES





AUTHOR: Michael Haken

LAST UPDATE: 2/12/2018



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



PS C:\\>$MembershipInfo = Set-GoogleDirectoryGroupMemberRole -GroupKey NNN -UserId user@google.com -Role MANAGER

-ClientId $Id -Persist -PassThru



This example changes the member user@google.com from MEMBER to MANAGER in the group identified by NNN and returns

the user's membership info for the group to

the pipeline. The call is authenticated with an access token stored in a client profile, which is refreshed if

necessary.

Any updated tokens are persisted to disk.











RELATED LINKS