# encoding: ascii
# api: powershell
# title: Grant-RegistryAccessFull
# description: From Windows PowerShell Cookbook (O’Reilly) by Lee Holmes
# version: 0.1
# author: Lee Holmes
# license: CC0
# x-poshcode-id: 4853
# x-archived: 2016-03-18T23:48:04
# x-published: 2016-01-30T14:09:00
#
#
##############################################################################
##
## Grant-RegistryAccessFullControl
##
## From Windows PowerShell Cookbook (O'Reilly)
## by Lee Holmes (http://www.leeholmes.com/guide)
##
##############################################################################
<#
.SYNOPSIS
Grants full control access to a user for the specified registry key.
.EXAMPLE
PS >$registryPath = "HKLM:\Software\MyProgram"
PS >Grant-RegistryAccessFullControl "LEE-DESK\LEE" $registryPath
#>
param(
## The user to grant full control
[Parameter(Mandatory = $true)]
$User,
## The registry path that should have its permissions modified
[Parameter(Mandatory = $true)]
$RegistryPath
)
Set-StrictMode -Version Latest
Push-Location
Set-Location -LiteralPath $registryPath
## Retrieve the ACL from the registry key
$acl = Get-Acl .
## Prepare the access rule, and set the access rule
$arguments = $user,"FullControl","Allow"
$accessRule = New-Object Security.AccessControl.RegistryAccessRule $arguments
$acl.SetAccessRule($accessRule)
## Apply the modified ACL to the regsitry key
$acl | Set-Acl .
Pop-Location