Public/Groups/Get-ZoomGroups.ps1
|
<# .SYNOPSIS List groups under your account. .DESCRIPTION List groups under your account. Prerequisite: Pro, Business, or Education account .PARAMETER FullApiResponse The switch FullApiResponse will return the default Zoom API response. The default response looks like: total_records groups ------------- ------ 9 {@{id=..... .OUTPUTS The key 'group' of the Zoom response (an object). Example: id name total_members -- ---- ------------- wxsZ8asdSdskqOxLPGXqA Light Side 2 -BqNhqJWQe-Fdro8FMkLA Dark Side 280 .LINK https://marketplace.zoom.us/docs/api-reference/zoom-api/groups/groups .EXAMPLE Get all groups. Get-ZoomGroups .EXAMPLE Get groups that have 'Dark Side' in the name. ((Get-ZoomGroups) | where-object {$_ -eq '*Dark Side*'}).id .EXAMPLE Get the default Zoom API response. Get-ZoomGroups -FullApiResponse #> function Get-ZoomGroups { [CmdletBinding()] param ( [switch]$FullApiResponse ) process { $Request = [System.UriBuilder]"https://api.$ZoomURI/v2/groups" $response = Invoke-ZoomRestMethod -Uri $request.Uri -Method GET if ($FullApiResponse) { Write-Output $response } else { Write-Output $response.groups } } } |