DSCResources/MSFT_SPProjectServerGlobalPermissions/MSFT_SPProjectServerGlobalPermissions.psm1
|
$script:resourceModulePath = Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent $script:modulesFolderPath = Join-Path -Path $script:resourceModulePath -ChildPath 'Modules' $script:resourceHelperModulePath = Join-Path -Path $script:modulesFolderPath -ChildPath 'SharePointDsc.Util' Import-Module -Name (Join-Path -Path $script:resourceHelperModulePath -ChildPath 'SharePointDsc.Util.psm1') function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [System.String] $Url, [Parameter(Mandatory = $true)] [System.String] $EntityName, [Parameter(Mandatory = $true)] [ValidateSet("User", "Group")] [System.String] $EntityType, [Parameter()] [System.String[]] $AllowPermissions, [Parameter()] [System.String[]] $DenyPermissions, [Parameter()] [System.Management.Automation.PSCredential] $InstallAccount ) Write-Verbose -Message "Getting global permissions for $EntityType '$EntityName' at '$Url'" if ((Get-SPDscInstalledProductVersion).FileMajorPart -lt 16) { throw [Exception] ("Support for Project Server in SharePointDsc is only valid for " + ` "SharePoint 2016 and 2019.") } $result = Invoke-SPDscCommand -Credential $InstallAccount ` -Arguments @($PSBoundParameters, $PSScriptRoot) ` -ScriptBlock { $params = $args[0] $scriptRoot = $args[1] if ((Get-SPProjectPermissionMode -Url $params.Url) -ne "ProjectServer") { throw [Exception] ("SPProjectServerGlobalPermissions is designed for Project Server " + ` "permissions mode only, and this site is set to SharePoint mode") } $modulePath = "..\..\Modules\SharePointDsc.ProjectServer\ProjectServerConnector.psm1" Import-Module -Name (Join-Path -Path $scriptRoot -ChildPath $modulePath -Resolve) $allowPermissions = @() $denyPermissions = @() $script:resultDataSet = $null switch ($params.EntityType) { "User" { $webAppUrl = (Get-SPSite -Identity $params.Url).WebApplication.Url $useKerberos = -not (Get-SPAuthenticationProvider -WebApplication $webAppUrl -Zone Default).DisableKerberos $resourceService = New-SPDscProjectServerWebService -PwaUrl $params.Url ` -EndpointName Resource ` -UseKerberos:$useKerberos $userId = Get-SPDscProjectServerResourceId -PwaUrl $params.Url -ResourceName $params.EntityName Use-SPDscProjectServerWebService -Service $resourceService -ScriptBlock { $script:resultDataSet = $resourceService.ReadResourceAuthorization($userId) } } "Group" { $webAppUrl = (Get-SPSite -Identity $params.Url).WebApplication.Url $useKerberos = -not (Get-SPAuthenticationProvider -WebApplication $webAppUrl -Zone Default).DisableKerberos $securityService = New-SPDscProjectServerWebService -PwaUrl $params.Url ` -EndpointName Security ` -UseKerberos:$useKerberos Use-SPDscProjectServerWebService -Service $securityService -ScriptBlock { $groupInfo = $securityService.ReadGroupList().SecurityGroups | Where-Object -FilterScript { $_.WSEC_GRP_NAME -eq $params.EntityName } $script:resultDataSet = $securityService.ReadGroup($groupInfo.WSEC_GRP_UID) } } } $script:resultDataSet.GlobalPermissions.Rows | ForEach-Object -Process { $permissionName = Get-SPDscProjectServerPermissionName -PermissionId $_.WSEC_FEA_ACT_UID if ($_.WSEC_ALLOW -eq $true) { $allowPermissions += $permissionName } if ($_.WSEC_DENY -eq $true) { $denyPermissions += $permissionName } } return @{ Url = $params.Url EntityName = $params.EntityName EntityType = $params.EntityType AllowPermissions = $allowPermissions DenyPermissions = $denyPermissions } } return $result } function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $Url, [Parameter(Mandatory = $true)] [System.String] $EntityName, [Parameter(Mandatory = $true)] [ValidateSet("User", "Group")] [System.String] $EntityType, [Parameter()] [System.String[]] $AllowPermissions, [Parameter()] [System.String[]] $DenyPermissions, [Parameter()] [System.Management.Automation.PSCredential] $InstallAccount ) Write-Verbose -Message "Setting global permissions for $EntityType '$EntityName' at '$Url'" $currentValues = Get-TargetResource @PSBoundParameters $result = Invoke-SPDscCommand -Credential $InstallAccount ` -Arguments @($PSBoundParameters, $PSScriptRoot, $currentValues) ` -ScriptBlock { $params = $args[0] $scriptRoot = $args[1] $currentValues = $args[2] $modulePath = "..\..\Modules\SharePointDsc.ProjectServer\ProjectServerConnector.psm1" Import-Module -Name (Join-Path -Path $scriptRoot -ChildPath $modulePath -Resolve) $allowPermsToAdd = @() $allowPermsToRemove = @() $denyPermsToAdd = @() $denyPermsToRemove = @() if ($params.ContainsKey("AllowPermissions") -eq $true) { $allowPermsDifference = Compare-Object -ReferenceObject $currentValues.AllowPermissions ` -DifferenceObject $params.AllowPermissions $allowPermsDifference | ForEach-Object -Process { $diff = $_ switch ($diff.SideIndicator) { "<=" { $allowPermsToRemove += $diff.InputObject } "=>" { $allowPermsToAdd += $diff.InputObject } } } } if ($params.ContainsKey("DenyPermissions") -eq $true) { $denyPermsDifference = Compare-Object -ReferenceObject $currentValues.DenyPermissions ` -DifferenceObject $params.DenyPermissions $denyPermsDifference | ForEach-Object -Process { $diff = $_ switch ($diff.SideIndicator) { "<=" { $denyPermsToRemove += $diff.InputObject } "=>" { $denyPermsToAdd += $diff.InputObject } } } } switch ($params.EntityType) { "User" { $webAppUrl = (Get-SPSite -Identity $params.Url).WebApplication.Url $useKerberos = -not (Get-SPAuthenticationProvider -WebApplication $webAppUrl -Zone Default).DisableKerberos $resourceService = New-SPDscProjectServerWebService -PwaUrl $params.Url ` -EndpointName Resource ` -UseKerberos:$useKerberos $userId = Get-SPDscProjectServerResourceId -PwaUrl $params.Url -ResourceName $params.EntityName Use-SPDscProjectServerWebService -Service $resourceService -ScriptBlock { $dataSet = $resourceService.ReadResourceAuthorization($userId) $allowPermsToAdd | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.NewGlobalPermissionsRow() $row.RES_UID = $userId $row.WSEC_FEA_ACT_UID = $permissionId $row.WSEC_ALLOW = $true $row.WSEC_DENY = $false $dataSet.GlobalPermissions.AddGlobalPermissionsRow($row) } $allowPermsToRemove | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.FindByWSEC_FEA_ACT_UIDRES_UID($permissionId, $userId) $row.Delete() } $denyPermsToAdd | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.NewGlobalPermissionsRow() $row.RES_UID = $userId $row.WSEC_FEA_ACT_UID = $permissionId $row.WSEC_ALLOW = $false $row.WSEC_DENY = $true $dataSet.GlobalPermissions.AddGlobalPermissionsRow($row) } $denyPermsToRemove | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.FindByWSEC_FEA_ACT_UIDRES_UID($permissionId, $userId) $row.Delete() } $resourceService.UpdateResources($dataSet, $false, $true) } } "Group" { $webAppUrl = (Get-SPSite -Identity $params.Url).WebApplication.Url $useKerberos = -not (Get-SPAuthenticationProvider -WebApplication $webAppUrl -Zone Default).DisableKerberos $securityService = New-SPDscProjectServerWebService -PwaUrl $params.Url ` -EndpointName Security ` -UseKerberos:$useKerberos Use-SPDscProjectServerWebService -Service $securityService -ScriptBlock { $groupInfo = $securityService.ReadGroupList().SecurityGroups | Where-Object -FilterScript { $_.WSEC_GRP_NAME -eq $params.EntityName } $dataSet = $securityService.ReadGroup($groupInfo.WSEC_GRP_UID) $allowPermsToAdd | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.NewGlobalPermissionsRow() $row.WSEC_GRP_UID = $groupInfo.WSEC_GRP_UID $row.WSEC_FEA_ACT_UID = $permissionId $row.WSEC_ALLOW = $true $row.WSEC_DENY = $false $dataSet.GlobalPermissions.AddGlobalPermissionsRow($row) } $allowPermsToRemove | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.FindByWSEC_FEA_ACT_UIDWSEC_GRP_UID($permissionId, $groupInfo.WSEC_GRP_UID) $row.Delete() } $denyPermsToAdd | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.NewGlobalPermissionsRow() $row.WSEC_GRP_UID = $groupInfo.WSEC_GRP_UID $row.WSEC_FEA_ACT_UID = $permissionId $row.WSEC_ALLOW = $false $row.WSEC_DENY = $true $dataSet.GlobalPermissions.AddGlobalPermissionsRow($row) } $denyPermsToRemove | ForEach-Object -Process { $permissionId = Get-SPDscProjectServerGlobalPermissionId -PermissionName $_ $row = $dataSet.GlobalPermissions.FindByWSEC_FEA_ACT_UIDWSEC_GRP_UID($permissionId, $groupInfo.WSEC_GRP_UID) $row.Delete() } $securityService.SetGroups($dataSet) } } } } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [System.String] $Url, [Parameter(Mandatory = $true)] [System.String] $EntityName, [Parameter(Mandatory = $true)] [ValidateSet("User", "Group")] [System.String] $EntityType, [Parameter()] [System.String[]] $AllowPermissions, [Parameter()] [System.String[]] $DenyPermissions, [Parameter()] [System.Management.Automation.PSCredential] $InstallAccount ) Write-Verbose -Message "Testing global permissions for $EntityType '$EntityName' at '$Url'" $CurrentValues = Get-TargetResource @PSBoundParameters Write-Verbose -Message "Current Values: $(Convert-SPDscHashtableToString -Hashtable $CurrentValues)" Write-Verbose -Message "Target Values: $(Convert-SPDscHashtableToString -Hashtable $PSBoundParameters)" return Test-SPDscParameterState -CurrentValues $CurrentValues ` -DesiredValues $PSBoundParameters ` -ValuesToCheck @( "AllowPermissions", "DenyPermissions" ) } Export-ModuleMember -Function *-TargetResource |