core/api/m365/SharePointOnline/csom/helpers/permission/Get-MonkeyCSOMListPermission.ps1
|
# Monkey365 - the PowerShell Cloud Security Tool for Azure and Microsoft 365 (copyright 2022) by Juan Garrido # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. Function Get-MonkeyCSOMListPermission{ <# .SYNOPSIS .DESCRIPTION .INPUTS .OUTPUTS .EXAMPLE .NOTES Author : Juan Garrido Twitter : @tr1ana File Name : Get-MonkeyCSOMListPermission Version : 1.0 .LINK https://github.com/silverhack/monkey365 #> [CmdletBinding(DefaultParameterSetName = 'Current')] Param ( [parameter(Mandatory=$false, HelpMessage="Authentication Object")] [Object]$Authentication, [parameter(Mandatory=$true, ParameterSetName = 'Web', ValueFromPipeline = $true, HelpMessage="Web Object")] [Object]$Web, [parameter(Mandatory=$true, ParameterSetName = 'Endpoint', HelpMessage="SharePoint Url")] [Object]$Endpoint, [Parameter(Mandatory=$false, HelpMessage="Lists to filter")] [string[]]$Filter, [parameter(Mandatory=$false, HelpMessage="Include lists")] [Switch]$IncludeItems, [parameter(Mandatory=$false, HelpMessage="Include lists")] [Switch]$ExcludeFolders, [Parameter(Mandatory= $false, HelpMessage="Include inherited permissions")] [Switch]$IncludeInheritedPermission ) Begin{ #Get permission params $permParam = Set-CommandParameter -Command "Get-MonkeyCSOMPermission" -Params $PSBoundParameters $job_params = @{ Command = "Get-MonkeyCSOMPermission"; Arguments = $permParam; Runspacepool = $O365Object.monkey_runspacePool; ReuseRunspacePool = $true; Debug = $O365Object.debug; Verbose = $O365Object.verbose; MaxQueue = $O365Object.MaxQueue; BatchSleep = $O365Object.BatchSleep; BatchSize = $O365Object.BatchSize; Throttle = $O365Object.nestedRunspaceMaxThreads; } } Process{ $p = Set-CommandParameter -Command "Get-MonkeyCSOMList" -Params $PSBoundParameters $Lists = Get-MonkeyCSOMList @p -ExcludeInternalLists; if($null -ne $Lists){ $permParam = Set-CommandParameter -Command "Get-MonkeyCSOMPermission" -Params $PSBoundParameters if($PSBoundParameters.ContainsKey('IncludeInheritedPermission') -and $PSBoundParameters['IncludeInheritedPermission'].IsPresent){ $Lists | Invoke-MonkeyJob @job_params; } Else{ $_lists = @($Lists).Where({$_ | Test-HasUniqueRoleAssignment}) if(@($_lists).Count -gt 0){ $_lists | Invoke-MonkeyJob @job_params; } } #Check for items if($PSBoundParameters.ContainsKey('IncludeItems') -and $PSBoundParameters['IncludeItems'].IsPresent){ $p = Set-CommandParameter -Command "Get-MonkeyCSOMListItemPermission" -Params $PSBoundParameters $Lists | Get-MonkeyCSOMListItemPermission @p; } } } } |