GAM Commands Reference¶

Komplett referanse for GAM-kommandoer brukt i Google Workspace-migrering

1. Grunnleggende kommandoer¶

Versjon og konfigurasjon¶

# Vis GAM-versjon
gam version

# Vis domene-info
gam info domain

# Vis konfigurasjonsfil-plassering
gam config

2. Autoriser og oppsett¶

Første gangs oppsett¶

# Opprett Google Cloud-prosjekt
gam create project

# Opprett OAuth2-autorisering
gam oauth create

# Test tilkobling
gam info domain

3. Grupper (Groups)¶

Liste alle grupper¶

# Eksporter alle grupper til CSV
gam print groups > all_groups.csv

# Vis detaljer om en gruppe
gam info group GRUPPENAVN@DOMENE.no

Opprett gruppe¶

# Opprett ny gruppe
gam create group GRUPPENAVN@DOMENE.no name "Visningsnavn" description "Beskrivelse"

# Eksempel
gam create group styret@skigk.no name "Styret" description "Styrets hovedgruppe"

Legg til medlemmer¶

# Legg til ett medlem
gam update group GRUPPENAVN@DOMENE.no add member EPOST@DOMENE.no

# Legg til medlem med rolle
gam update group GRUPPENAVN@DOMENE.no add owner EPOST@DOMENE.no
gam update group GRUPPENAVN@DOMENE.no add manager EPOST@DOMENE.no
gam update group GRUPPENAVN@DOMENE.no add member EPOST@DOMENE.no

# Legg til flere medlemmer fra fil
gam update group GRUPPENAVN@DOMENE.no add members file members.txt

Fjern medlemmer¶

# Fjern ett medlem
gam update group GRUPPENAVN@DOMENE.no remove member EPOST@DOMENE.no

# Fjern alle medlemmer
gam update group GRUPPENAVN@DOMENE.no clear members

Eksporter gruppemedlemmer¶

# Eksporter medlemmer i én gruppe
gam print group-members group GRUPPENAVN@DOMENE.no > members.csv

# Eksporter medlemmer i alle grupper
gam print group-members > all_group_members.csv

Slett gruppe¶

# Slett en gruppe (FARLIG - bruk med forsiktighet!)
gam delete group GRUPPENAVN@DOMENE.no

4. Aliaser (Aliases)¶

Opprett alias¶

# Opprett alias for gruppe
gam create alias ALIAS@DOMENE.no group GRUPPENAVN@DOMENE.no

# Opprett alias for bruker
gam create alias ALIAS@DOMENE.no user BRUKER@DOMENE.no

Liste aliaser¶

# Vis aliaser for gruppe
gam info group GRUPPENAVN@DOMENE.no

# Vis aliaser for bruker
gam info user BRUKER@DOMENE.no

Slett alias¶

# Slett alias
gam delete alias ALIAS@DOMENE.no

5. Shared Drives (Team Drives)¶

Liste Shared Drives¶

# Liste alle delte disker
gam print teamdrives > shared_drives.csv

# Vis info om en delt disk
gam info teamdrive DRIVE_ID
gam info teamdrive "Diskens navn"

Opprett Shared Drive¶

# Opprett ny delt disk (krever Team Drive API aktivert)
gam create teamdrive "Diskens navn"

Eksporter tilganger (ACL)¶

# Eksporter tilganger for en delt disk
gam show drivefileacl DRIVE_ID > acl_output.csv

# Med spesifikk format
gam print drivefileacl DRIVE_ID > acl_output.csv

Gi tilgang til Shared Drive¶

# Gi gruppe tilgang
gam add drivefileacl DRIVE_ID anyone organizer emailaddress GRUPPE@DOMENE.no
gam add drivefileacl DRIVE_ID anyone fileOrganizer emailaddress GRUPPE@DOMENE.no
gam add drivefileacl DRIVE_ID anyone writer emailaddress GRUPPE@DOMENE.no
gam add drivefileacl DRIVE_ID anyone commenter emailaddress GRUPPE@DOMENE.no
gam add drivefileacl DRIVE_ID anyone reader emailaddress GRUPPE@DOMENE.no

# Roller:
# - organizer: Full kontroll
# - fileOrganizer: Innholdsansvarlig
# - writer: Bidragsyter
# - commenter: Kommentator
# - reader: Leser

Fjern tilgang¶

# Fjern bruker/gruppe fra delt disk
gam remove drivefileacl DRIVE_ID EPOST@DOMENE.no

6. Brukere (Users)¶

Liste brukere¶

# Eksporter alle brukere
gam print users > all_users.csv

# Vis info om en bruker
gam info user BRUKER@DOMENE.no

Opprett bruker¶

# Opprett ny bruker
gam create user BRUKER@DOMENE.no firstname "Fornavn" lastname "Etternavn" password "TempPassord123"

# Opprett bruker og send velkomst-epost
gam create user BRUKER@DOMENE.no firstname "Fornavn" lastname "Etternavn" password "TempPassord123" notify BRUKER@DOMENE.no

Oppdater bruker¶

# Endre passord
gam update user BRUKER@DOMENE.no password "NyttPassord123"

# Tvinge passordbyte ved neste innlogging
gam update user BRUKER@DOMENE.no changepassword on

# Endre navn
gam update user BRUKER@DOMENE.no firstname "NyttFornavn" lastname "NyttEtternavn"

Suspender/reaktiver bruker¶

# Suspender bruker (deaktiver)
gam update user BRUKER@DOMENE.no suspended on

# Reaktiver bruker
gam update user BRUKER@DOMENE.no suspended off

Slett bruker¶

# Slett bruker (FARLIG!)
gam delete user BRUKER@DOMENE.no

7. Organisasjonsenheter (Organizational Units)¶

Liste OUer¶

# Eksporter alle organisasjonsenheter
gam print orgs > orgs.csv

Opprett OU¶

# Opprett ny OU
gam create org "/Navn på OU" description "Beskrivelse"

Flytt bruker til OU¶

# Flytt bruker
gam update user BRUKER@DOMENE.no org "/Navn på OU"

8. Rapporter og logging¶

Eksporter fullstendig rapport¶

# Alle grupper med medlemmer
gam print group-members > full_group_report.csv

# Alle brukere med detaljer
gam print users > full_user_report.csv

# Alle delte disker med tilganger
gam print teamdrives > shared_drives_report.csv

Drive-aktivitet¶

# Vis aktivitet på en fil/mappe
gam show fileinfo <FILE_ID>

9. Batch-operasjoner¶

Oppdater flere brukere fra CSV¶

# CSV-fil med kolonner: email, firstname, lastname
gam csv users.csv gam update user ~email firstname ~firstname lastname ~lastname

Legg til flere medlemmer i gruppe fra CSV¶

# CSV-fil med kolonne: email
gam csv members.csv gam update group GRUPPENAVN@DOMENE.no add member ~email

10. Feilsøking og debugging¶

Vis detaljert output¶

# Kjør kommando med debug-modus
gam debug 5 info domain

# Debug-nivå:
# 0 = Ingen debug
# 1 = Minimal
# 5 = Full

Sjekk API-kvoter¶

# Vis API-bruk
gam report usage customer parameters "accounts:num_users"

11. Eksempelscripts (PowerShell)¶

Eksporter alle ACLer for Shared Drives¶

$drives = @{
    'Styret' = 'DRIVE_ID_1'
    'Økonomi' = 'DRIVE_ID_2'
}

foreach ($kvp in $drives.GetEnumerator()) {
    $name = $kvp.Key
    $id = $kvp.Value
    $outfile = "reports/drive_${name}_acl_$(Get-Date -Format 'yyyyMMdd').csv"
    gam show drivefileacl $id > $outfile
}

Eksporter alle gruppemedlemmer¶

$groups = @('styret@skigk.no', 'okonomi@skigk.no', 'kasserer@skigk.no')

foreach ($group in $groups) {
    $outfile = "reports/${group}_members_$(Get-Date -Format 'yyyyMMdd').csv"
    gam print group-members group $group > $outfile
}

12. Viktige notater¶

Tilgangsroller oversikt¶

Grupper: - OWNER - Kan endre gruppeinnstillinger og slette gruppen - MANAGER - Kan legge til/fjerne medlemmer - MEMBER - Vanlig medlem

Shared Drives: - organizer - Full kontroll (kan slette disken) - fileOrganizer - Innholdsansvarlig (kan administrere filer og medlemmer) - writer - Bidragsyter (kan legge til og redigere filer) - commenter - Kommentator (kan legge til kommentarer) - reader - Leser (kun lesetilgang)

Beste praksis¶

Test alle kommandoer i testmiljø først
Ta backup før bulk-operasjoner
Bruk CSV for batch-operasjoner
Dokumenter alle endringer
Bruk spesifikke roller (ikke gi organizer til alle)

Ressurser¶

Versjon: 1.0
Sist oppdatert: 1. desember 2025