diff --git a/wiki/Cloud-Identity-Groups.md b/wiki/Cloud-Identity-Groups.md index 10392305..26f27684 100644 --- a/wiki/Cloud-Identity-Groups.md +++ b/wiki/Cloud-Identity-Groups.md @@ -1,10 +1,11 @@ # Cloud Identity Groups - [API documentation](#api-documentation) - [Query documentation](#query-documentation) -- [Python Regular Expressions](Python-Regular-Expressions) Match function +- [Python Regular Expressions](Python-Regular-Expressions) Match function and Search function - [Notes](#Notes) - [Definitions](#definitions) - [Manage groups](#manage-groups) +- [Update a group's primary email address](#update-a-groups-primary-email-address) - [Display information about individual groups](#display-information-about-individual-groups) - [Display information about multiple groups](#display-information-about-multiple-groups) - [Display group counts](#display-group-counts) @@ -259,6 +260,19 @@ You can update a group to restrict its membership with the `memberrestrictions < The `makeowner` option makes the administrator in `oauth2.txt` the initial owner of the group. +## Update a group's primary email address +You can simply update a group's primary email address with the `email` option. +``` +gam update cigroup groupold@domain.com email groupnew@domain.com +``` +The `updateprimaryemail ` option allows modification several group's +current primary email address. For example, to change the domain of a set of groups from the current domain.com to newdomain.com, +make a CSV file Groups.csv with a column `email` that contains the group email addresses that are to be changed. +``` +gam update cigroup csvfile Groups.csv:email updateprimaryemail "^(.+)@domain.com$" "\1@newdomain.com" +``` +If the group's current primary email address does not match the then no modification is made. + ## Display information about individual groups This command displays information as an indented list of keys and values. ``` diff --git a/wiki/GamUpdates.md b/wiki/GamUpdates.md index 6d23ed6e..055c15ab 100644 --- a/wiki/GamUpdates.md +++ b/wiki/GamUpdates.md @@ -10,6 +10,16 @@ Add the `-s` option to the end of the above commands to suppress creating the `g See [Downloads-Installs-GAM7](https://github.com/GAM-team/GAM/wiki/Downloads-Installs) for Windows or other options, including manual installation +### 7.39.04 + +Added `updateprimaryemail ` option to +`gam update group ` and `gam update cigroup ` to allow modifying +the group's current primary email address. +For example, to change the domain of a set of groups from the current domain.com to newdomain.com: +``` +gam update group csvfile Groups.csv:email updateprimaryemail "^(.+)@domain.com$" "\1@newdomain.com" +``` + ### 7.39.03 Added the following options to `gam create chatspace` that can be used to capture diff --git a/wiki/Groups.md b/wiki/Groups.md index 77034810..d8755227 100644 --- a/wiki/Groups.md +++ b/wiki/Groups.md @@ -1,12 +1,13 @@ # Groups - [API documentation](#api-documentation) - [Query documentation](#query-documentation) -- [Python Regular Expressions](Python-Regular-Expressions) Match function +- [Python Regular Expressions](Python-Regular-Expressions) Match function and Search function - [Definitions](#definitions) - [GUI API Group settings mapping](#gui-api-group-settings-mapping) - [GUI API Group access type settings mapping](#gui-api-group-access-type-settings-mapping) - [whoCanViewMembership and whoCanDiscoverGroup interactions](#whocanviewmembership-and-whocandiscovergroup-interactions) - [Manage groups](#manage-groups) +- [Update a group's primary email address](#update-a-groups-primary-email-address) - [Update a group's settings with JSON data](#update-a-groups-settings-with-json-data) - [Display information about specific groups](#display-information-about-specific-groups) - [Display information about selected groups](#display-information-about-selected-groups) @@ -348,6 +349,7 @@ gam create group [copyfrom ] * [verifynotinvitable] gam update group|groups [email ] + [updateprimaryemail ] [copyfrom ] * [makesecuritygroup|security] [admincreated ] @@ -363,6 +365,19 @@ You can update a group to a security group with the `makesecuritygroup` option. When deleting and `noactionifalias` is specified, no action is performed if `` specifies an alias rather than a primary email address. +## Update a group's primary email address +You can simply update a group's primary email address with the `email` option. +``` +gam update group groupold@domain.com email groupnew@domain.com +``` +The `updateprimaryemail ` option allows modification several group's +current primary email address. For example, to change the domain of a set of groups from the current domain.com to newdomain.com, +make a CSV file Groups.csv with a column `email` that contains the group email addresses that are to be changed. +``` +gam update group csvfile Groups.csv:email updateprimaryemail "^(.+)@domain.com$" "\1@newdomain.com" +``` +If the group's current primary email address does not match the then no modification is made. + ## Update a group's settings with JSON data You can save group settings in JSON format which can simplify updating multiple settings. Suppose you have a set of test groups that you will use to experiment with the new group settings coming in May 2019. You diff --git a/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md b/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md index 23a1cfb3..afbe6ef5 100644 --- a/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md +++ b/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md @@ -251,7 +251,7 @@ writes the credentials into the file oauth2.txt. ``` gamteam@server:/Users/gamteam$ rm -f /Users/gamteam/GAMConfig/oauth2.txt gamteam@server:/Users/gamteam$ gam version -GAM 7.39.03 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.39.04 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.3 64-bit final macOS Tahoe 26.3.1 arm64 @@ -1034,7 +1034,7 @@ writes the credentials into the file oauth2.txt. ``` C:\>del C:\GAMConfig\oauth2.txt C:\>gam version -GAM 7.39.03 - https://github.com/GAM-team/GAM - pythonsource +GAM 7.39.04 - https://github.com/GAM-team/GAM - pythonsource GAM Team Python 3.14.3 64-bit final Windows 11 10.0.26200 AMD64 diff --git a/wiki/Users.md b/wiki/Users.md index 3c797e0a..70f7e250 100644 --- a/wiki/Users.md +++ b/wiki/Users.md @@ -814,9 +814,9 @@ gam update user userold@domain.com primaryemail usernew@domain.com ``` The `updateprimaryemail ` option allows modification of the user's current primary email address. -For example, to change the domain of a set of users from the current domain to newdomain.com: +For example, to change the domain of a set of users from the current domain.com to newdomain.com: ``` -gam ou /Path/To/Ou update user updateprimaryemail "^(.+)@.*$" "\1@newdomain.com" +gam ou /Path/To/Ou update user updateprimaryemail "^(.+)@domain.com$" "\1@newdomain.com" ``` To change graduating students email addresses from flastname@domain.com to flastname_grad@domain.com: ``` diff --git a/wiki/Version-and-Help.md b/wiki/Version-and-Help.md index 7ca0f857..be546719 100644 --- a/wiki/Version-and-Help.md +++ b/wiki/Version-and-Help.md @@ -3,7 +3,7 @@ Print the current version of Gam with details ``` gam version -GAM 7.39.03 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.39.04 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.3 64-bit final macOS Tahoe 26.3.1 arm64 @@ -15,7 +15,7 @@ Time: 2026-02-15T07:51:00-08:00 Print the current version of Gam with details and time offset information ``` gam version timeoffset -GAM 7.39.03 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.39.04 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.3 64-bit final macOS Tahoe 26.3.1 arm64 @@ -27,7 +27,7 @@ Your system time differs from www.googleapis.com by less than 1 second Print the current version of Gam with extended details and SSL information ``` gam version extended -GAM 7.39.03 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.39.04 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.3 64-bit final macOS Tahoe 26.3.1 arm64 @@ -68,7 +68,7 @@ MacOS High Sierra 10.13.6 x86_64 Path: /Users/gamteam/bin/gam7 Version Check: Current: 5.35.08 - Latest: 7.39.03 + Latest: 7.39.04 echo $? 1 ``` @@ -76,7 +76,7 @@ echo $? Print the current version number without details ``` gam version simple -7.39.03 +7.39.04 ``` In Linux/MacOS you can do: ``` @@ -86,7 +86,7 @@ echo $VER Print the current version of Gam and address of this Wiki ``` gam help -GAM 7.39.03 - https://github.com/GAM-team/GAM +GAM 7.39.04 - https://github.com/GAM-team/GAM GAM Team Python 3.14.3 64-bit final macOS Tahoe 26.3.1 arm64