updated get-teamviewerrole function with permissions

Author: radu-cristea-15

Cmdlets/Public/Get-TeamViewerRole.ps1

@@ -3,22 +3,35 @@ function Get-TeamViewerRole {
     param(
         [Parameter(Mandatory = $true)]
         [securestring]
-        $ApiToken
+        $ApiToken,
+
+        [switch]
+        [Alias('ListPermissions')]
+        $Permissions
     )
 
-    Begin{
-    $parameters = @{ }
-    $resourceUri = "$(Get-TeamViewerApiUri)/userroles"
+    Begin {
+        $parameters = @{ }
+        $resourceUri = "$(Get-TeamViewerApiUri)/userroles"
+        if ($Permissions) {
+            $resourceUri += '/permissions'
+        }
     }
 
-Process{
-    $response = Invoke-TeamViewerRestMethod `
-        -ApiToken $ApiToken `
-        -Uri $resourceUri `
-        -Method Get `
-        -Body $parameters `
-        -WriteErrorTo $PSCmdlet `
-        -ErrorAction Stop
-    Write-Output ($response.Roles | ConvertTo-TeamViewerRole )
-}
+    Process {
+        $response = Invoke-TeamViewerRestMethod `
+            -ApiToken $ApiToken `
+            -Uri $resourceUri `
+            -Method Get `
+            -Body $parameters `
+            -WriteErrorTo $PSCmdlet `
+            -ErrorAction Stop
+        if ($Permissions) {
+            return [PSCustomObject] $response
+        }
+        else {
+            Write-Output ($response.Roles | ConvertTo-TeamViewerRole )
+        }
+    }
 }
+

Tests/Public/Get-TeamViewerRole.Tests.ps1

@@ -61,6 +61,14 @@ Describe 'Get-TeamViewerRole' {
                 $Uri -eq '//unit.test/userroles' -And `
                 $Method -eq 'Get' }
     }
+    It 'Should call the correct API endpoint to list permissions' {
+        Get-TeamViewerRole -ApiToken $testApiToken -Permissions
+
+        Assert-MockCalled Invoke-TeamViewerRestMethod -Times 1 -Scope It -ParameterFilter {
+            $ApiToken -eq $testApiToken -And `
+                $Uri -eq '//unit.test/userroles/permissions' -And `
+                $Method -eq 'Get' }
+    }
 
     It 'Should return Role objects' {
         $result = Get-TeamViewerRole -ApiToken $testApiToken