Public/Get-MITGroup.ps1
|
function Get-MITGroup { <# .SYNOPSIS Get MOVEit Transfer Group(s) .LINK Get list of groups current user can view https://docs.ipswitch.com/MOVEit/Transfer2021/Api/Rest/#operation/GETapi/v1/groups?Page={Page}&PerPage={PerPage}-1.0 #> [CmdletBinding()] param ( [Parameter()] [int32]$Page, [Parameter()] [int32]$PerPage, [Parameter()] [switch]$IncludePaging ) try { # Confirm the token, refreshing if necessary Confirm-MITToken # Set the Uri for this request $uri = "$script:BaseUri/groups" # Set the request headers $headers = @{ Accept = "application/json" Authorization = "Bearer $($script:Token.AccessToken)" } # Build the query parameters. $query = @{} switch ($PSBoundParameters.Keys) { Page { $query['page'] = $Page } PerPage { $query['perPage'] = $PerPage } } # Send the request and write out the response $response = Invoke-RestMethod -Uri "$uri" -Headers $headers -Body $query $response | Write-MITResponse -Typename 'MITGroupSimple' -IncludePaging:$IncludePaging } catch { $PSCmdlet.ThrowTerminatingError($PSItem) } } |