Public/Public/Groups/UserGroups/Get-JCUserGroupMember.ps1
|
Function Get-JCUserGroupMember () { [CmdletBinding(DefaultParameterSetName = 'ByGroup')] param ( [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'ByGroup', Position = 0, HelpMessage = 'The name of the JumpCloud User Group you want to return the members of.')] [Alias('name')] [String]$GroupName, [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'ByID', HelpMessage = 'If searching for a User Group using the GroupID populate the GroupID in the -ByID field.')] [String]$ByID ) begin { Write-Debug 'Verifying JCAPI Key' if ($JCAPIKEY.length -ne 40) {Connect-JConline} Write-Debug 'Initilizing resultsArray and results ArraryByID' $rawResults = @() $resultsArray = @() if ($PSCmdlet.ParameterSetName -eq 'ByGroup') { Write-Debug 'Populating GroupNameHash' $GroupNameHash = Get-Hash_UserGroupName_ID Write-Debug 'Populating UserIDHash' $UserIDHash = Get-Hash_ID_Username } } process { if ($PSCmdlet.ParameterSetName -eq 'ByGroup') { foreach ($Group in $GroupName) { if ($GroupNameHash.containsKey($Group)) { $Group_ID = $GroupNameHash.Get_Item($Group) Write-Debug "$Group_ID" $limitURL = "{0}/api/v2/usergroups/{1}/members" -f $JCUrlBasePath, $Group_ID Write-Debug $limitURL $rawResults = Get-JCResults -Url $limitURL -method "GET" -limit 100 foreach ($uid in $rawResults) { $Username = $UserIDHash.Get_Item($uid.to.id) $FomattedResult = [pscustomobject]@{ 'GroupName' = $GroupName 'Username' = $Username 'UserID' = $uid.to.id } $resultsArray += $FomattedResult } $rawResults = $null } else { Throw "Group does not exist. Run 'Get-JCGroup -type User' to see a list of all your JumpCloud user groups."} } } elseif ($PSCmdlet.ParameterSetName -eq 'ByID') { $limitURL = "{0}/api/v2/usergroups/{1}/members" -f $JCUrlBasePath, $ByID Write-Debug $limitURL $resultsArray = Get-JCResults -Url $limitURL -method "GET" -limit 100 } } end { return $resultsArray } } |