Public/Set-Owner.ps1

<#PSScriptInfo
 
.VERSION 1.1.5
 
.GUID fb1d15b5-4681-4f99-90d6-1fd44ed4219b
 
.AUTHOR Jason Cook Boe Prox
 
.COMPANYNAME Tectic
 
.COPYRIGHT Copyright (c) Tectic 2025
 
.TAGS
 
.LICENSEURI
 
.PROJECTURI
 
.ICONURI
 
.EXTERNALMODULEDEPENDENCIES
 
.REQUIREDSCRIPTS
 
.EXTERNALSCRIPTDEPENDENCIES
 
.RELEASENOTES
 
.PRIVATEDATA
 
#>
 





<#
.SYNOPSIS
    Changes owner of a file or folder to another user or group.

.DESCRIPTION
    Changes owner of a file or folder to another user or group.

.PARAMETER Path
    The folder or file that will have the owner changed.

.PARAMETER Account
    Optional parameter to change owner of a file or folder to specified account.

    Default value is 'Builtin\Administrators'

.PARAMETER Recurse
    Recursively set ownership on subfolders and files beneath given folder.

.EXAMPLE
    Set-Owner -Path C:\temp\test.txt

    Description
    -----------
    Changes the owner of test.txt to Builtin\Administrators

.EXAMPLE
    Set-Owner -Path C:\temp\test.txt -Account 'Domain\bprox

    Description
    -----------
    Changes the owner of test.txt to Domain\bprox

.EXAMPLE
    Set-Owner -Path C:\temp -Recurse

    Description
    -----------
    Changes the owner of all files and folders under C:\Temp to Builtin\Administrators

.EXAMPLE
    Get-ChildItem C:\Temp | Set-Owner -Recurse -Account 'Domain\bprox'

    Description
    -----------
    Changes the owner of all files and folders under C:\Temp to Domain\bprox

.LINK
https://learn-powershell.net/2014/06/24/changing-ownership-of-file-or-folder-using-powershell/

.LINK
http://gallery.technet.microsoft.com/scriptcenter/Set-Owner-ff4db177
    #>

[CmdletBinding(
  SupportsShouldProcess = $True
)]
param(
  [parameter(ValueFromPipeline = $True, ValueFromPipelineByPropertyName = $True)]
  [Alias('FullName')]
  [string[]]$Path,
  [parameter()]
  [string]$Account = 'Builtin\Administrators',
  [parameter()]
  [switch]$Recurse
)
Begin {
  #Prevent Confirmation on each Write-Debug command when using -Debug
  If ($PSBoundParameters['Debug']) {
    $DebugPreference = 'Continue'
  }
  Try {
    [void][TokenAdjuster]
  }
  Catch {
    $AdjustTokenPrivileges = @"
            using System;
            using System.Runtime.InteropServices;

             public class TokenAdjuster
             {
              [DllImport("advapi32.dll", ExactSpelling = true, SetLastError = true)]
              internal static extern bool AdjustTokenPrivileges(IntPtr htok, bool disall,
              ref TokPriv1Luid newst, int len, IntPtr prev, IntPtr relen);
              [DllImport("kernel32.dll", ExactSpelling = true)]
              internal static extern IntPtr GetCurrentProcess();
              [DllImport("advapi32.dll", ExactSpelling = true, SetLastError = true)]
              internal static extern bool OpenProcessToken(IntPtr h, int acc, ref IntPtr
              phtok);
              [DllImport("advapi32.dll", SetLastError = true)]
              internal static extern bool LookupPrivilegeValue(string host, string name,
              ref long pluid);
              [StructLayout(LayoutKind.Sequential, Pack = 1)]
              internal struct TokPriv1Luid
              {
               public int Count;
               public long Luid;
               public int Attr;
              }
              internal const int SE_PRIVILEGE_DISABLED = 0x00000000;
              internal const int SE_PRIVILEGE_ENABLED = 0x00000002;
              internal const int TOKEN_QUERY = 0x00000008;
              internal const int TOKEN_ADJUST_PRIVILEGES = 0x00000020;
              public static bool AddPrivilege(string privilege)
              {
               try
               {
                bool retVal;
                TokPriv1Luid tp;
                IntPtr hproc = GetCurrentProcess();
                IntPtr htok = IntPtr.Zero;
                retVal = OpenProcessToken(hproc, TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, ref htok);
                tp.Count = 1;
                tp.Luid = 0;
                tp.Attr = SE_PRIVILEGE_ENABLED;
                retVal = LookupPrivilegeValue(null, privilege, ref tp.Luid);
                retVal = AdjustTokenPrivileges(htok, false, ref tp, 0, IntPtr.Zero, IntPtr.Zero);
                return retVal;
               }
               catch (Exception ex)
               {
                throw ex;
               }
              }
              public static bool RemovePrivilege(string privilege)
              {
               try
               {
                bool retVal;
                TokPriv1Luid tp;
                IntPtr hproc = GetCurrentProcess();
                IntPtr htok = IntPtr.Zero;
                retVal = OpenProcessToken(hproc, TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, ref htok);
                tp.Count = 1;
                tp.Luid = 0;
                tp.Attr = SE_PRIVILEGE_DISABLED;
                retVal = LookupPrivilegeValue(null, privilege, ref tp.Luid);
                retVal = AdjustTokenPrivileges(htok, false, ref tp, 0, IntPtr.Zero, IntPtr.Zero);
                return retVal;
               }
               catch (Exception ex)
               {
                throw ex;
               }
              }
             }
"@

    Add-Type $AdjustTokenPrivileges
  }

  #Activate necessary admin privileges to make changes without NTFS perms
  [void][TokenAdjuster]::AddPrivilege("SeRestorePrivilege") #Necessary to set Owner Permissions
  [void][TokenAdjuster]::AddPrivilege("SeBackupPrivilege") #Necessary to bypass Traverse Checking
  [void][TokenAdjuster]::AddPrivilege("SeTakeOwnershipPrivilege") #Necessary to override FilePermissions
}
Process {
  ForEach ($Item in $Path) {
    Write-Verbose "FullName: $Item"
    #The ACL objects do not like being used more than once, so re-create them on the Process block
    $DirOwner = New-Object System.Security.AccessControl.DirectorySecurity
    $DirOwner.SetOwner([System.Security.Principal.NTAccount]$Account)
    $FileOwner = New-Object System.Security.AccessControl.FileSecurity
    $FileOwner.SetOwner([System.Security.Principal.NTAccount]$Account)
    $DirAdminAcl = New-Object System.Security.AccessControl.DirectorySecurity
    $FileAdminAcl = New-Object System.Security.AccessControl.DirectorySecurity
    $AdminACL = New-Object System.Security.AccessControl.FileSystemAccessRule('Builtin\Administrators', 'FullControl', 'ContainerInherit,ObjectInherit', 'InheritOnly', 'Allow')
    $FileAdminAcl.AddAccessRule($AdminACL)
    $DirAdminAcl.AddAccessRule($AdminACL)
    Try {
      $Item = Get-Item -LiteralPath $Item -Force -ErrorAction Stop
      If (-NOT $Item.PSIsContainer) {
        If ($PSCmdlet.ShouldProcess($Item, 'Set File Owner')) {
          Try {
            $Item.SetAccessControl($FileOwner)
          }
          Catch {
            Write-Warning "Couldn't take ownership of $($Item.FullName)! Taking FullControl of $($Item.Directory.FullName)"
            $Item.Directory.SetAccessControl($FileAdminAcl)
            $Item.SetAccessControl($FileOwner)
          }
        }
      }
      Else {
        If ($PSCmdlet.ShouldProcess($Item, 'Set Directory Owner')) {
          Try {
            $Item.SetAccessControl($DirOwner)
          }
          Catch {
            Write-Warning "Couldn't take ownership of $($Item.FullName)! Taking FullControl of $($Item.Parent.FullName)"
            $Item.Parent.SetAccessControl($DirAdminAcl)
            $Item.SetAccessControl($DirOwner)
          }
        }
        If ($Recurse) {
          [void]$PSBoundParameters.Remove('Path')
          Get-ChildItem $Item -Force | Set-Owner @PSBoundParameters
        }
      }
    }
    Catch {
      Write-Warning "$($Item): $($_.Exception.Message)"
    }
  }
}
End {
  #Remove priviledges that had been granted
  [void][TokenAdjuster]::RemovePrivilege("SeRestorePrivilege")
  [void][TokenAdjuster]::RemovePrivilege("SeBackupPrivilege")
  [void][TokenAdjuster]::RemovePrivilege("SeTakeOwnershipPrivilege")
}