V2.20.1 - added Update-GSGroupMember for #121

.gitignore

@@ -12,3 +12,4 @@ FunctionBackups
 FunctionBackups/*
 BuildOutput/*
 *config.csv
+PSGSuite.zip

CHANGELOG.md

@@ -1,66 +1,76 @@
 # Changelog
 
 * [Changelog](#changelog)
- * [2.20.0](#2200)
- * [2.19.0](#2190)
- * [2.18.1](#2181)
- * [2.18.0](#2180)
- * [2.17.2](#2172)
- * [2.17.1](#2171)
- * [2.17.0](#2170)
- * [2.16.1](#2161)
- * [2.16.0](#2160)
- * [2.15.4](#2154)
- * [2.15.3](#2153)
- * [2.15.2](#2152)
- * [2.15.1](#2151)
- * [2.15.0](#2150)
- * [2.14.1](#2141)
- * [2.14.0](#2140)
- * [2.13.2](#2132)
- * [2.13.1](#2131)
- * [2.13.0](#2130)
- * [2.12.1](#2121)
- * [2.12.0](#2120)
- * [2.11.0](#2110)
- * [2.10.2](#2102)
- * [2.10.1](#2101)
- * [2.10.0](#2100)
- * [2.9.0](#290)
- * [2.8.1](#281)
- * [2.8.0](#280)
- * [2.7.2](#272)
- * [2.7.1](#271)
- * [2.7.0](#270)
- * [2.6.3](#263)
- * [2.6.2](#262)
- * [2.6.1](#261)
- * [2.6.0](#260)
- * [2.5.4](#254)
- * [2.5.3](#253)
- * [2.5.2](#252)
- * [2.5.1](#251)
- * [2.5.0](#250)
- * [2.4.0](#240)
- * [2.3.0](#230)
- * [2.2.1](#221)
- * [2.2.0](#220)
- * [2.1.5](#215)
- * [2.1.3 / 2.1.4](#213--214)
- * [2.1.2](#212)
- * [2.1.1](#211)
- * [2.1.0](#210)
- * [2.0.3](#203)
- * [2.0.2](#202)
- * [2.0.1](#201)
- * [2.0.0](#200)
- * [New Functionality](#new-functionality)
- * [Breaking Changes in 2.0.0](#breaking-changes-in-200)
- * [Gmail Delegation Management Removed](#gmail-delegation-management-removed)
- * [Functions Removed](#functions-removed)
- * [Functions Aliased](#functions-aliased)
+ * [2.20.1](#2201)
+ * [2.20.0](#2200)
+ * [2.19.0](#2190)
+ * [2.18.1](#2181)
+ * [2.18.0](#2180)
+ * [2.17.2](#2172)
+ * [2.17.1](#2171)
+ * [2.17.0](#2170)
+ * [2.16.1](#2161)
+ * [2.16.0](#2160)
+ * [2.15.4](#2154)
+ * [2.15.3](#2153)
+ * [2.15.2](#2152)
+ * [2.15.1](#2151)
+ * [2.15.0](#2150)
+ * [2.14.1](#2141)
+ * [2.14.0](#2140)
+ * [2.13.2](#2132)
+ * [2.13.1](#2131)
+ * [2.13.0](#2130)
+ * [2.12.1](#2121)
+ * [2.12.0](#2120)
+ * [2.11.0](#2110)
+ * [2.10.2](#2102)
+ * [2.10.1](#2101)
+ * [2.10.0](#2100)
+ * [2.9.0](#290)
+ * [2.8.1](#281)
+ * [2.8.0](#280)
+ * [2.7.2](#272)
+ * [2.7.1](#271)
+ * [2.7.0](#270)
+ * [2.6.3](#263)
+ * [2.6.2](#262)
+ * [2.6.1](#261)
+ * [2.6.0](#260)
+ * [2.5.4](#254)
+ * [2.5.3](#253)
+ * [2.5.2](#252)
+ * [2.5.1](#251)
+ * [2.5.0](#250)
+ * [2.4.0](#240)
+ * [2.3.0](#230)
+ * [2.2.1](#221)
+ * [2.2.0](#220)
+ * [2.1.5](#215)
+ * [2.1.3 / 2.1.4](#213--214)
+ * [2.1.2](#212)
+ * [2.1.1](#211)
+ * [2.1.0](#210)
+ * [2.0.3](#203)
+ * [2.0.2](#202)
+ * [2.0.1](#201)
+ * [2.0.0](#200)
+ * [New Functionality](#new-functionality)
+ * [Breaking Changes in 2.0.0](#breaking-changes-in-200)
+ * [Gmail Delegation Management Removed](#gmail-delegation-management-removed)
+ * [Functions Removed](#functions-removed)
+ * [Functions Aliased](#functions-aliased)
 
 ***
+
+## 2.20.1
+
+* [Issue #121](https://github.com/scrthq/PSGSuite/issues/121)
+ * Added: `Update-GSGroupMember` to allow setting a group member's Role and/or DeliverySettings
+* Miscellaneous
+ * Added: GitHub release automation to deploy task
+ * Added: Twitter update automation on new version release to deploy task
+
 ## 2.20.0
 
 * [Issue #115](https://github.com/scrthq/PSGSuite/issues/115)

PSGSuite/PSGSuite.psd1

@@ -12,7 +12,7 @@
  RootModule = 'PSGSuite.psm1'
 
  # Version number of this module.
- ModuleVersion = '2.20.0'
+ ModuleVersion = '2.20.1'
 
  # ID used to uniquely identify this module
  GUID = '9d751152-e83e-40bb-a6db-4c329092aaec'
@@ -128,7 +128,7 @@ All other functions are either intact or have an alias included to support backw
  # Prerelease = '-alpha'
 
  # Tags applied to this module. These help with module discovery in online galleries.
- Tags = 'Google', 'GSuite', 'Apps', 'G', 'Suite', 'REST', 'API', 'Admin', 'PSModule', 'Directory', 'User', 'Goo.gl', 'PSEdition_Core', 'PSEdition_Desktop'
+ Tags = 'GSuite', 'Google', 'Apps', 'API', 'Drive', 'Gmail', 'Admin', 'Automation', 'PSEdition_Core', 'PSEdition_Desktop'
 
  # A URL to the license for this module.
  # LicenseUri = ''

PSGSuite/Public/Groups/Get-GSGroupMember.ps1

@@ -44,13 +44,11 @@ function Get-GSGroupMember {
  $PageSize="200"
  )
  Begin {
- if ($PSCmdlet.ParameterSetName -eq 'Get') {
- $serviceParams = @{
- Scope = 'https://www.googleapis.com/auth/admin.directory.group'
- ServiceType = 'Google.Apis.Admin.Directory.directory_v1.DirectoryService'
- }
- $service = New-GoogleService @serviceParams
+ $serviceParams = @{
+ Scope = 'https://www.googleapis.com/auth/admin.directory.group'
+ ServiceType = 'Google.Apis.Admin.Directory.directory_v1.DirectoryService'
  }
+ $service = New-GoogleService @serviceParams
  }
  Process {
  switch ($PSCmdlet.ParameterSetName) {
@@ -80,7 +78,44 @@ function Get-GSGroupMember {
  }
  }
  List {
- Get-GSGroupMemberListPrivate @PSBoundParameters
+ foreach ($Id in $Identity) {
+ try {
+ if ($Id -notlike "*@*.*") {
+ $Id = "$($Id)@$($Script:PSGSuite.Domain)"
+ }
+ $request = $service.Members.List($Id)
+ if ($PageSize) {
+ $request.MaxResults = $PageSize
+ }
+ if ($Roles) {
+ Write-Verbose "Getting all members of group '$Id' in the following role(s): $($Roles -join ',')"
+ $request.Roles = "$($Roles -join ',')"
+ }
+ else {
+ Write-Verbose "Getting all members of group '$Id'"
+ }
+ [int]$i = 1
+ do {
+ $result = $request.Execute()
+ if ($null -ne $result.MembersValue) {
+ $result.MembersValue | Add-Member -MemberType NoteProperty -Name 'Group' -Value $Id -PassThru | Add-Member -MemberType ScriptMethod -Name ToString -Value {$this.Email} -PassThru -Force
+ }
+ $request.PageToken = $result.NextPageToken
+ [int]$retrieved = ($i + $result.MembersValue.Count) - 1
+ Write-Verbose "Retrieved $retrieved members..."
+ [int]$i = $i + $result.MembersValue.Count
+ }
+ until (!$result.NextPageToken)
+ }
+ catch {
+ if ($ErrorActionPreference -eq 'Stop') {
+ $PSCmdlet.ThrowTerminatingError($_)
+ }
+ else {
+ Write-Error $_
+ }
+ }
+ }
  }
  }
  }

PSGSuite/Public/Groups/Update-GSGroupMember.ps1

@@ -0,0 +1,107 @@
+function Update-GSGroupMember {
+ <#
+ .SYNOPSIS
+ Updates a group member's role and/or delivery preference
+
+ .DESCRIPTION
+ Updates a group member's role and/or delivery preference
+
+ .PARAMETER GroupEmail
+ The email or GroupID of the group to update members of
+
+ .PARAMETER Member
+ The member email or list of member emails that you would like to update
+
+ .PARAMETER Role
+ The role that you would like to update the members to
+
+ Acceptable values are:
+ * MEMBER
+ * MANAGER
+ * OWNER
+
+ .PARAMETER DeliverySettings
+ Defines mail delivery preferences of member
+
+ Acceptable values are:
+ * "ALL_MAIL": All messages, delivered as soon as they arrive.
+ * "DAILY": No more than one message a day.
+ * "DIGEST": Up to 25 messages bundled into a single message.
+ * "DISABLED": Remove subscription.
+ * "NONE": No messages.
+
+ .EXAMPLE
+ Get-GSGroupMember myGroup | Update-GSGroupMember -DeliverySettings ALL_MAIL
+
+ Updates the delivery preference for all members of group 'myGroup@domain.com' to 'ALL_MAIL'
+ #>
+ [cmdletbinding()]
+ Param
+ (
+ [parameter(Mandatory = $true,Position = 0,ValueFromPipeline = $true,ValueFromPipelineByPropertyName = $true)]
+ [Alias('Group')]
+ [String]
+ $GroupEmail,
+ [parameter(Mandatory = $true,Position = 1,ValueFromPipelineByPropertyName = $true)]
+ [Alias("PrimaryEmail","UserKey","Mail","User","UserEmail","Email")]
+ [ValidateNotNullOrEmpty()]
+ [String[]]
+ $Member,
+ [parameter(Mandatory = $false)]
+ [ValidateSet("MEMBER","MANAGER","OWNER")]
+ [String]
+ $Role,
+ [parameter(Mandatory = $false)]
+ [ValidateSet("ALL_MAIL","DAILY","DIGEST","DISABLED","NONE")]
+ [String]
+ $DeliverySettings
+ )
+ Begin {
+ $serviceParams = @{
+ Scope = 'https://www.googleapis.com/auth/admin.directory.group'
+ ServiceType = 'Google.Apis.Admin.Directory.directory_v1.DirectoryService'
+ }
+ $service = New-GoogleService @serviceParams
+ }
+ Process {
+ try {
+ if ($GroupEmail -notlike "*@*.*") {
+ $GroupEmail = "$($GroupEmail)@$($Script:PSGSuite.Domain)"
+ }
+ #$groupObj = Get-GSGroup -Group $Identity -Verbose:$false
+ try {
+ foreach ($U in $Member) {
+ if ($U -notlike "*@*.*") {
+ $U = "$($U)@$($Script:PSGSuite.Domain)"
+ }
+ Write-Verbose "Updating member '$U' of group '$GroupEmail'"
+ $body = New-Object 'Google.Apis.Admin.Directory.directory_v1.Data.Member'
+ if ($PSBoundParameters.Keys -contains 'DeliverySettings') {
+ $body.DeliverySettings = $PSBoundParameters['DeliverySettings']
+ }
+ if ($PSBoundParameters.Keys -contains 'Role') {
+ $body.Role = $PSBoundParameters['Role']
+ }
+ $request = $service.Members.Patch($body,$GroupEmail,$U)
+ $request.Execute() | Add-Member -MemberType NoteProperty -Name 'Group' -Value $GroupEmail -PassThru
+ }
+ }
+ catch {
+ if ($ErrorActionPreference -eq 'Stop') {
+ $PSCmdlet.ThrowTerminatingError($_)
+ }
+ else {
+ Write-Error $_
+ }
+ }
+ }
+ catch {
+ if ($ErrorActionPreference -eq 'Stop') {
+ $PSCmdlet.ThrowTerminatingError($_)
+ }
+ else {
+ Write-Error $_
+ }
+ }
+ }
+}