.TH "GCLOUD_ALPHA_IDENTITY_GROUPS_UPDATE" 1



.SH "NAME"
.HP
gcloud alpha identity groups update \- update a group



.SH "SYNOPSIS"
.HP
\f5gcloud alpha identity groups update\fR \fIEMAIL\fR [\fB\-\-dynamic\-user\-query\fR=\fIDYNAMIC_USER_QUERY\fR] [\fB\-\-clear\-posix\-groups\fR\ |\ \fB\-\-remove\-posix\-groups\fR=[\fIPOSIX_GROUP\fR,...]] [\fB\-\-clear\-description\fR\ |\ \fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-clear\-display\-name\fR\ |\ \fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Update a group.



.SH "EXAMPLES"

To update a group:

.RS 2m
$ gcloud alpha identity groups update eng\-discuss@foo.com \e
    \-\-display\-name="New Engineer Discuss" \e
    \-\-description="Group for engineering discussions"
.RE

To remove POSIX information from a Google Group:

.RS 2m
$ gcloud alpha identity groups update eng\-discuss@foo.com \e
    \-\-remove\-posix\-groups=eng
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIEMAIL\fR

The email address of the group to be updated.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-dynamic\-user\-query\fR=\fIDYNAMIC_USER_QUERY\fR

Query that determines the memberships of the dynamic group.

Example of a query:
\f5\-\-dynamic\-user\-query="user.organizations.exists(org,org.title=='SWE')"\fR

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-posix\-groups\fR

Clear all POSIX groups from the specified Cloud Identity group.

.TP 2m
\fB\-\-remove\-posix\-groups\fR=[\fIPOSIX_GROUP\fR,...]

Remove POSIX groups from the specified Cloud Identity group. You can specify
multiple POSIX groups by either name or gid by using a comma\-separated list.

For example, use '\-\-remove\-posix\-groups=1005,1006' to remove POSIX groups
with group ids '1005' and '1006', or use '\-\-remove\-posix\-groups=eng,docs' to
remove POSIX groups named 'eng' and 'docs'.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-description\fR

Clear existing description on group being updated.

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

Replace existing description on group being updated.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-display\-name\fR

Clear existing display name on group being updated.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

Replace existing display name on group being updated.


.RE
.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBcloudidentity/v1alpha1\fR API. The full documentation
for this API can be found at: https://cloud.google.com/identity/



.SH "NOTES"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

.RS 2m
$ gcloud identity groups update
.RE

.RS 2m
$ gcloud beta identity groups update
.RE