diff --git a/docs/Cloud-Identity-Groups.md b/docs/Cloud-Identity-Groups.md index 8edc527c..7e54a57c 100644 --- a/docs/Cloud-Identity-Groups.md +++ b/docs/Cloud-Identity-Groups.md @@ -367,6 +367,11 @@ When using the `formatjson` option, double quotes are used extensively in the da The `quotechar ` option allows you to choose an alternate quote character, single quote for instance, that makes for readable/processable output. `quotechar` defaults to `gam.cfg/csv_output_quote_char`. When uploading CSV files to Google, double quote `"` should be used. +### Display dynamic groups +``` +gam print cigroups query "'cloudidentity.googleapis.com/groups.dynamic' in labels" +``` + ### Display security groups ``` gam print cigroups query "'cloudidentity.googleapis.com/groups.security' in labels" diff --git a/docs/Command-Line-Parsing.md b/docs/Command-Line-Parsing.md index 9f6f35f5..52f6ee9a 100644 --- a/docs/Command-Line-Parsing.md +++ b/docs/Command-Line-Parsing.md @@ -16,6 +16,10 @@ To embed a `'` in a string enclosed in `"`, enter `'`; `name "Test'Group"`. To embed a `"` in a string enclosed in `'`, enter `"`; `name 'Test"Group'`. +To embed a `'` in a string enclosed in `'`, enter `'\''"`; `name 'Test'\''Group'`. + +To embed a `"` in a string enclosed in `"`, enter `\"`; `name "Test\"Group"`. + Linux and MacOS do not recognize smart or curly quotes, `“` and `”`, they can not be used to enclose arguments. ## Windows Command Prompt diff --git a/docs/GamUpdates.md b/docs/GamUpdates.md index 30d8d2d6..a51f60bf 100644 --- a/docs/GamUpdates.md +++ b/docs/GamUpdates.md @@ -10,6 +10,13 @@ Add the `-s` option to the end of the above commands to suppress creating the `g See [Downloads](https://github.com/taers232c/GAMADV-XTD3/wiki/Downloads) for Windows or other options, including manual installation. +### 6.63.08 + +Updated `cigroup` commands to handle the following error: +``` +ERROR: 400: invalidArgument - Request contains an invalid argument. +``` + ### 6.63.07 Fixed bug in `gam append sheetrange` that caused a trap when appending to an empty sheet. diff --git a/docs/How-to-Upgrade-from-Standard-GAM.md b/docs/How-to-Upgrade-from-Standard-GAM.md index e54eac08..30f96465 100644 --- a/docs/How-to-Upgrade-from-Standard-GAM.md +++ b/docs/How-to-Upgrade-from-Standard-GAM.md @@ -330,7 +330,7 @@ writes the credentials into the file oauth2.txt. admin@server:/Users/admin/bin/gamadv-xtd3$ rm -f /Users/admin/GAMConfig/oauth2.txt admin@server:/Users/admin/bin/gamadv-xtd3$ ./gam version WARNING: Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: /Users/admin/GAMConfig/oauth2.txt, Not Found -GAMADV-XTD3 6.63.07 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.63.08 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.10.8 64-bit final MacOS High Sierra 10.13.6 x86_64 @@ -972,7 +972,7 @@ writes the credentials into the file oauth2.txt. C:\GAMADV-XTD3>del C:\GAMConfig\oauth2.txt C:\GAMADV-XTD3>gam version WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found -GAMADV-XTD3 6.63.07 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.63.08 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.5 64-bit final Windows-10-10.0.17134 AMD64 diff --git a/docs/Users-Drive-Files-Manage.md b/docs/Users-Drive-Files-Manage.md index 37d7e101..63c7e37b 100644 --- a/docs/Users-Drive-Files-Manage.md +++ b/docs/Users-Drive-Files-Manage.md @@ -205,9 +205,9 @@ without any conversion. Standard GAM had an option `convert` that was passed to * convert - Whether to convert this file to the corresponding Docs Editors format Advanced GAM uses Drive API v3 that doesn't support the `convert` option; it uses the `mimetype` argument to cause conversions. -* `mimetype gdoc` - Convert the uploaded content to a Google Doc; e.g., convert a Word (.docx) file to a Google Doc -* `mimetype gsheet` - Convert the uploaded content to a Google Sheet; e.g., convert an Excel (.xlsx) file to a Google Sheet -* `mimetype gpresentation` - Convert the uploaded content to a Google Slides; e.g., convert an PowerPoint (.pptx) file to a Google Slides +* `mimetype gdoc` - Convert the uploaded content to a Google Doc; e.g., convert a Word (.docx) or text (.txt) file to a Google Doc +* `mimetype gsheet` - Convert the uploaded content to a Google Sheet; e.g., convert an Excel (.xlsx) or CSV (.csv) file to a Google Sheet +* `mimetype gpresentation` - Convert the uploaded content to a Google Slides; e.g., convert a PowerPoint (.pptx) file to a Google Slides By default, the user, file name and id values are displayed on stdout. * `returnidonly` - Display just the file ID of the created file on stdout diff --git a/docs/Using-GAMADV-XTD3-with-a-YubiKey.md b/docs/Using-GAMADV-XTD3-with-a-YubiKey.md index 9e96cef0..6bb12d94 100644 --- a/docs/Using-GAMADV-XTD3-with-a-YubiKey.md +++ b/docs/Using-GAMADV-XTD3-with-a-YubiKey.md @@ -1,5 +1,6 @@ # Using GAMADV-XTD3 with a YubiKey - [Thanks](#thanks) +- [Yubikey ykman PIV Commands](https://docs.yubico.com/software/yubikey/tools/ykman/PIV_Commands.html) - [Introduction](#introduction) - [FAQs](#faqs) - [Setup Steps](#setup-steps) @@ -42,11 +43,11 @@ When using domain-wide delegation with GAMADV-XTD3, the service account and anyo 4. **If you are already using the YubiKey and wish to preserve the PIV app data and keys** 1. You need to configure one of the PIV slots for a private key GAMADV-XTD3 can use. * [ykman piv keys generate](https://docs.yubico.com/software/yubikey/tools/ykman/PIV_Commands.html#ykman-piv-keys-options-command-args) - `ykman piv keys generate -P some_pin --pin-policy ALWAYS --touch-policy NEVER --algorithm RSA2048 9a new_pubkey.txt` + `ykman piv keys generate -P --pin-policy ALWAYS --touch-policy NEVER --algorithm RSA2048 9a new_pubkey.txt` * Use `9a` for the `AUTHENTICATION` slot, `9c` for the `SIGNATURE` slot 2. You need to generate a certificate for that slot. * [ykman piv certificates generate](https://docs.yubico.com/software/yubikey/tools/ykman/PIV_Commands.html#ykman-piv-certificates-generate-options-slot-public-key) - `ykman piv certificates generate -P some_pin --subject "GAM Service Account" -d 36500 9a new_pubkey.txt` + `ykman piv certificates generate -P --subject "GAM Service Account" -d 36500 9a new_pubkey.txt` * Use `9a` for the `AUTHENTICATION` slot, `9c` for the `SIGNATURE` slot 5. Now that you have a private key on your YubiKey, tell GAMADV-XTD3 to use that instead of the private_key stored in oauth2service.json. We can do that by rotating the key: diff --git a/docs/Version-and-Help.md b/docs/Version-and-Help.md index 0c02c892..49e0c47e 100644 --- a/docs/Version-and-Help.md +++ b/docs/Version-and-Help.md @@ -3,7 +3,7 @@ Print the current version of Gam with details ``` gam version -GAMADV-XTD3 6.63.07 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.63.08 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.5 64-bit final MacOS Monterey 12.6.6 x86_64 @@ -15,7 +15,7 @@ Time: 2023-06-02T21:10:00-07:00 Print the current version of Gam with details and time offset information ``` gam version timeoffset -GAMADV-XTD3 6.63.07 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.63.08 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.5 64-bit final MacOS Monterey 12.6.6 x86_64 @@ -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 -GAMADV-XTD3 6.63.07 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource +GAMADV-XTD3 6.63.08 - https://github.com/taers232c/GAMADV-XTD3 - pythonsource Ross Scroggs Python 3.11.5 64-bit final MacOS Monterey 12.6.6 x86_64 @@ -64,7 +64,7 @@ MacOS High Sierra 10.13.6 x86_64 Path: /Users/Admin/bin/gamadv-xtd3 Version Check: Current: 5.35.08 - Latest: 6.63.07 + Latest: 6.63.08 echo $? 1 ``` @@ -72,7 +72,7 @@ echo $? Print the current version number without details ``` gam version simple -6.63.07 +6.63.08 ``` In Linux/MacOS you can do: ``` @@ -82,7 +82,7 @@ echo $VER Print the current version of Gam and address of this Wiki ``` gam help -GAM 6.63.07 - https://github.com/taers232c/GAMADV-XTD3 +GAM 6.63.08 - https://github.com/taers232c/GAMADV-XTD3 Ross Scroggs Python 3.11.5 64-bit final MacOS Monterey 12.6.6 x86_64