Takeown.psm1
|
# Module created by Microsoft.PowerShell.Crescendo class PowerShellCustomFunctionAttribute : System.Attribute { [bool]$RequiresElevation [string]$Source PowerShellCustomFunctionAttribute() { $this.RequiresElevation = $false; $this.Source = "Microsoft.PowerShell.Crescendo" } PowerShellCustomFunctionAttribute([bool]$rElevation) { $this.RequiresElevation = $rElevation $this.Source = "Microsoft.PowerShell.Crescendo" } } function Set-Ownership { [PowerShellCustomFunctionAttribute(RequiresElevation=$False)] [CmdletBinding()] param( [Parameter()] [string]$ComputerName, [Parameter()] [string]$RunAs, [Parameter()] [string]$Password, [Parameter()] [string]$Path, [Parameter()] [switch]$GiveAdminGroupOwnership, [Parameter()] [switch]$Recurse, [Parameter()] [string]$SupressConfirmation ) BEGIN { $__PARAMETERMAP = @{ ComputerName = @{ OriginalName = '/s' OriginalPosition = '0' Position = '1' ParameterType = 'string' ApplyToExecutable = $False NoGap = $False } RunAs = @{ OriginalName = '/u' OriginalPosition = '1' Position = '2' ParameterType = 'string' ApplyToExecutable = $False NoGap = $False } Password = @{ OriginalName = '/p' OriginalPosition = '2' Position = '3' ParameterType = 'string' ApplyToExecutable = $False NoGap = $False } Path = @{ OriginalName = '/f' OriginalPosition = '3' Position = '4' ParameterType = 'string' ApplyToExecutable = $False NoGap = $False } GiveAdminGroupOwnership = @{ OriginalName = '/a' OriginalPosition = '4' Position = '5' ParameterType = 'switch' ApplyToExecutable = $False NoGap = $False } Recurse = @{ OriginalName = '/r' OriginalPosition = '5' Position = '6' ParameterType = 'switch' ApplyToExecutable = $False NoGap = $False } SupressConfirmation = @{ OriginalName = '/d' OriginalPosition = '6' Position = '7' ParameterType = 'string' ApplyToExecutable = $False NoGap = $False } } $__outputHandlers = @{ Default = @{ StreamOutput = $true; Handler = { $input } } } } PROCESS { $__boundParameters = $PSBoundParameters $__defaultValueParameters = $PSCmdlet.MyInvocation.MyCommand.Parameters.Values.Where({$_.Attributes.Where({$_.TypeId.Name -eq "PSDefaultValueAttribute"})}).Name $__defaultValueParameters.Where({ !$__boundParameters["$_"] }).ForEach({$__boundParameters["$_"] = get-variable -value $_}) $__commandArgs = @() $MyInvocation.MyCommand.Parameters.Values.Where({$_.SwitchParameter -and $_.Name -notmatch "Debug|Whatif|Confirm|Verbose" -and ! $__boundParameters[$_.Name]}).ForEach({$__boundParameters[$_.Name] = [switch]::new($false)}) if ($__boundParameters["Debug"]){wait-debugger} foreach ($paramName in $__boundParameters.Keys| Where-Object {!$__PARAMETERMAP[$_].ApplyToExecutable}| Sort-Object {$__PARAMETERMAP[$_].OriginalPosition}) { $value = $__boundParameters[$paramName] $param = $__PARAMETERMAP[$paramName] if ($param) { if ($value -is [switch]) { if ($value.IsPresent) { if ($param.OriginalName) { $__commandArgs += $param.OriginalName } } elseif ($param.DefaultMissingValue) { $__commandArgs += $param.DefaultMissingValue } } elseif ( $param.NoGap ) { $pFmt = "{0}{1}" if($value -match "\s") { $pFmt = "{0}""{1}""" } $__commandArgs += $pFmt -f $param.OriginalName, $value } else { if($param.OriginalName) { $__commandArgs += $param.OriginalName } $__commandArgs += $value | Foreach-Object {$_} } } } $__commandArgs = $__commandArgs | Where-Object {$_ -ne $null} if ($__boundParameters["Debug"]){wait-debugger} if ( $__boundParameters["Verbose"]) { Write-Verbose -Verbose -Message takeown.exe $__commandArgs | Write-Verbose -Verbose } $__handlerInfo = $__outputHandlers[$PSCmdlet.ParameterSetName] if (! $__handlerInfo ) { $__handlerInfo = $__outputHandlers["Default"] # Guaranteed to be present } $__handler = $__handlerInfo.Handler if ( $PSCmdlet.ShouldProcess("takeown.exe $__commandArgs")) { # check for the application and throw if it cannot be found if ( -not (Get-Command -ErrorAction Ignore "takeown.exe")) { throw "Cannot find executable 'takeown.exe'" } if ( $__handlerInfo.StreamOutput ) { & "takeown.exe" $__commandArgs | & $__handler } else { $result = & "takeown.exe" $__commandArgs & $__handler $result } } } # end PROCESS <# .SYNOPSIS TAKEOWN [/S system [/U username [/P [password]]]] /F filename [/A] [/R [/D prompt]] Description: This tool allows an administrator to recover access to a file that was denied by re-assigning file ownership. Parameter List: /S system Specifies the remote system to connect to. Now -ComputerName /U [domain\]user Specifies the user context under which the command should execute. Now -RunAs /P [password] Specifies the password for the given user context. Prompts for input if omitted. Now -Password /F filename Specifies the filename or directory name pattern. Wildcard "*" can be used to specify the pattern. Allows sharename\filename. Now -Path /A Gives ownership to the administrators group instead of the current user. Now -GiveAdminGroupOwnership /R Recurse: instructs tool to operate on files in specified directory and all subdirectories. Now -Recurse /D prompt Default answer used when the current user does not have the "list folder" permission on a directory. This occurs while operating recursively (/R) on sub-directories. Valid values "Y" to take ownership or "N" to skip. Now -SupressConfirmation NOTE: 1) If /A is not specified, file ownership will be given to the current logged on user. 2) Mixed patterns using "?" and "*" are not supported. 3) /D is used to suppress the confirmation prompt. Examples: TAKEOWN /? TAKEOWN /F lostfile TAKEOWN /F \\system\share\lostfile /A TAKEOWN /F directory /R /D N TAKEOWN /F directory /R /A TAKEOWN /F * TAKEOWN /F C:\Windows\System32\acme.exe TAKEOWN /F %windir%\*.txt TAKEOWN /S system /F MyShare\Acme*.doc TAKEOWN /S system /U user /F MyShare\MyBinary.dll TAKEOWN /S system /U domain\user /P password /F share\filename TAKEOWN /S system /U user /P password /F Doc\Report.doc /A TAKEOWN /S system /U user /P password /F Myshare\* TAKEOWN /S system /U user /P password /F Home\Logon /R TAKEOWN /S system /U user /P password /F Myshare\directory /R /A .DESCRIPTION See help for takeown.exe .PARAMETER ComputerName .PARAMETER RunAs .PARAMETER Password .PARAMETER Path .PARAMETER GiveAdminGroupOwnership .PARAMETER Recurse .PARAMETER SupressConfirmation #> } |