Scripts/Principals/get-cohesityviewforprincipal.ps1
|
function Get-CohesityViewForPrincipal { <# .SYNOPSIS The list of View names that the principal has permission to access. .DESCRIPTION The Get-CohesityViewForPrincipal function is used to fetch list of views that the principal has access. .EXAMPLE Get-CohesityViewForPrincipal -PrincipalType "USER" -PrincipalName user1 List all views for the pricipal type user. .EXAMPLE Get-CohesityViewForPrincipal -PrincipalType "GROUP" -PrincipalName user-group1 List all views for the pricipal type group. #> [OutputType('System.Array')] [CmdletBinding()] Param( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [ValidateSet("USER", "GROUP")] # Principal type "USER" or "GROUP" to differentiate between cohesity user and group. [string]$PrincipalType, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] # Principal name of "USER" or "GROUP" type. [string]$PrincipalName ) Begin { } Process { $principalSID = $null if ($PrincipalType -eq "USER") { $principalSID = (Get-CohesityUser | where-object { $_.UserName -eq $PrincipalName }).Sid if (-not $principalSID) { Write-Output "Pricipal '$PrincipalName' not found, please use cmdlet 'Get-CohesityUser' to identify the desired one." return } } elseif ($PrincipalType -eq "GROUP") { $principalSID = (Get-CohesityUserGroup | where-object { $_.Name -eq $PrincipalName }).Sid if (-not $principalSID) { Write-Output "Pricipal '$PrincipalName' not found, please use cmdlet 'Get-CohesityUserGroup' to identify the desired one." return } } else { Write-Output "Invalid parameter $PrincipalType" return } # Construct URL & header $cohesityClusterURL = '/irisservices/api/v1/public/principals/protectionSources?sids=' + $principalSID $principalAccessList = Invoke-RestApi -Method 'Get' -Uri $cohesityClusterURL # tagging reponse for display format ( configured in Cohesity.format.ps1xml ) @($principalAccessList | Add-Member -TypeName 'System.Object#ViewForPrincipal' -PassThru) } } |