.TH "GCLOUD_IDENTITY_GROUPS_UPDATE" 1



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



.SH "SYNOPSIS"
.HP
\f5gcloud identity groups update\fR \fIEMAIL\fR [\fB\-\-dynamic\-user\-query\fR=\fIDYNAMIC_USER_QUERY\fR] [\fB\-\-labels\fR=\fILABELS\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"

Update a group.



.SH "EXAMPLES"

To update a group:

.RS 2m
$ gcloud identity groups update eng\-discuss@foo.com \e
    \-\-display\-name="New Engineer Discuss" \e
    \-\-description="Group for engineering discussions"
.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
\fB\-\-labels\fR=\fILABELS\fR

One or more label entries that apply to the group. Currently supported labels
contain a key with an empty value.

Google Groups are the default type of group and have a label with a key of
\'cloudidentity.googleapis.com/groups.discussion_forum' and an empty value.

Existing Google Groups can have an additional label with a key of
\'cloudidentity.googleapis.com/groups.security' and an empty value added to
them. \fBThis is an immutable change and the security label cannot be removed
once added.\fR

Dynamic groups have a label with a key of
\'cloudidentity.googleapis.com/groups.dynamic'.

Identity\-mapped groups for Cloud Search have a label with a key of
\'system/groups/external' and an empty value.

Examples: {"cloudidentity.googleapis.com/groups.discussion_forum": ""} or
{"system/groups/external": ""}.

.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/v1\fR API. The full documentation for
this API can be found at: https://cloud.google.com/identity/



.SH "NOTES"

These variants are also available:

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

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