##############################################################################################################

function Find-Item {

[CmdletBinding()]

[Alias()]

param (

[parameter(

Mandatory = $true,

Position = 0,

HelpMessage = "Search phrase to look for",

ValueFromPipeline = $false

)]

[string] $SearchMask,

[Parameter(

HelpMessage = "Files only",

Mandatory = $false,

ValueFromPipeline = $false

)]

[switch] $File,

[Parameter(

HelpMessage = "Directory only",

Mandatory = $false,

ValueFromPipeline = $false

)]

[switch] $Directory

)

$findMask = @(Get-PSDrive -ErrorAction SilentlyContinue | ForEach-Object -ErrorAction SilentlyContinue {

if ($_.Provider.Name -eq "FileSystem") {

"$($_.Root)*$SearchMask*"

}

});

Get-ChildItem -Path $findMask -Recurse -File:$File -Directory:$Directory -ErrorAction SilentlyContinue

}

function ExpandPath([string] $FilePath, [bool] $CreateDirectory = $false) {

# root folder included?

if ($FilePath.Contains(":") -or $FilePath.StartsWith("\\")) {

try {

# just normalize

$FilePath = [System.IO.Path]::GetFullPath($FilePath);

}

catch {

# keep original

}

}

else {

# combine with users current directory

$FilePath = [System.IO.Path]::GetFullPath([System.IO.Path]::Combine($pwd, $FilePath));

}

# create directory?

if ($CreateDirectory) {

# get directory name

$directory = [System.IO.Path]::GetDirectoryName($FilePath);

# does not exist?

if (![IO.Directory]::Exists($directory)) {

# create it

[IO.Directory]::CreateDirectory($directory)

}

}

# remove trailing path delimiter

return [System.IO.Path]::TrimEndingDirectorySeparator($FilePath);

}

function Start-RoboCopy {

[CmdletBinding(

DefaultParameterSetName = "Default",

ConfirmImpact = "Medium"

)]

[Alias("xc")]

Param

(

################################################################################

[Parameter(

Mandatory,

Position = 0,

ValueFromPipeline = $false,

HelpMessage = "The directory, filepath, or directory+searchmask"

)]

[string]$Source,

################################################################################

[Parameter(

Mandatory = $false,

Position = 1,

ValueFromPipeline = $false,

HelpMessage = "The destination directory to place the copied files and directories into.

)]

[string]$DestinationDirectory = ".\",

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

Position = 2,

HelpMessage = "Optional searchmask for selecting the files that need to be copied.

)] [string[]] $Files = @(),

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Synchronizes the content of specified directories, will also delete any files and directories in the destination that do not exist in the source"

)]

[switch] $Mirror,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Will move instead of copy all files from source to destination"

)]

[switch] $Move,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Will also copy ownership, security descriptors and auditing information of files and directories"

)]

[switch] $IncludeSecurity,

################################################################################

################################################################################

[Parameter(

ParameterSetName = "Default",

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Copies only files from source and skips sub-directories (no recurse)"

)]

[switch] $SkipDirectories,

################################################################################

[Parameter(

ParameterSetName = "SkipDirectories",

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Does not copy directories if they would be empty"

)]

[switch] $SkipEmptyDirectories,

################################################################################

[Parameter(

ParameterSetName = "SkipDirectories",

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Create directory tree only"

)]

[switch] $CopyOnlyDirectoryTreeStructure,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Create directory tree and zero-length files only"

)]

[switch] $CopyOnlyDirectoryTreeStructureAndEmptyFiles,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Don't copy symbolic links, junctions or the content they point to"

)]

[switch] $SkipAllSymbolicLinks,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Don't copy file symbolic links but do follow directory junctions"

)]

[switch] $SkipSymbolicFileLinks,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Instead of copying the content where symbolic links point to, copy the links themselves"

)]

[switch] $CopySymbolicLinksAsLinks,

################################################################################

[Parameter(

ParameterSetName = "SkipDirectories",

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Don't copy directory junctions (symbolic link for a folder) or the content they point to"

)]

[switch] $SkipJunctions,

################################################################################

[Parameter(

ParameterSetName = "SkipDirectories",

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Instead of copying the content where junctions point to, copy the junctions themselves"

)]

[switch] $CopyJunctionsAsJunctons,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Will copy all files even if they are older then the ones in the destination"

)]

[switch] $Force,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Copies only files that have the archive attribute set"

)]

[switch] $SkipFilesWithoutArchiveAttribute,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "In addition of copying only files that have the archive attribute set, will then reset this attribute on the source"

)]

[switch] $ResetArchiveAttributeAfterSelection,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Exclude any files that matches any of these names/paths/wildcards"

)]

[string[]] $FileExcludeFilter = @(),

################################################################################

[Parameter(

ParameterSetName = "SkipDirectories",

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Exclude any directories that matches any of these names/paths/wildcards"

)]

[string[]] $DirectoryExcludeFilter = @(),

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Copy only files that have all these attributes set [RASHCNETO]"

)]

[string] $AttributeIncludeFilter,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Exclude files that have any of these attributes set [RASHCNETO]"

)]

[string] $AttributeExcludeFilter,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Will set the given attributes to copied files [RASHCNETO]"

)]

[string] $SetAttributesAfterCopy,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Will remove the given attributes from copied files [RASHCNETO]"

)]

[string] $RemoveAttributesAfterCopy,

################################################################################

################################################################################

[ValidateRange(1, 1000000)]

[Parameter(

ParameterSetName = "SkipDirectories",

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Only copy the top n levels of the source directory tree"

)]

[int] $MaxSubDirTreeLevelDepth = -1,

################################################################################

[ValidateRange(0, 9999999999999999)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Skip files that are not at least n bytes in size"

)]

[int] $MinFileSize = -1,

################################################################################

[ValidateRange(0, 9999999999999999)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Skip files that are larger then n bytes"

)]

[int] $MaxFileSize = -1,

################################################################################

[ValidateRange(0, 99999999)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Skip files that are not at least: n days old OR created before n date (if n < 1900 then n = n days, else n = YYYYMMDD date)"

)]

[int] $MinFileAge = -1,

################################################################################

[ValidateRange(0, 99999999)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Skip files that are older then: n days OR created after n date (if n < 1900 then n = n days, else n = YYYYMMDD date)"

)]

[int] $MaxFileAge = -1,

################################################################################

[ValidateRange(0, 99999999)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Skip files that are accessed within the last: n days OR before n date (if n < 1900 then n = n days, else n = YYYYMMDD date)"

)]

[int] $MinLastAccessAge = -1,

################################################################################

[ValidateRange(0, 99999999)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Skip files that have not been accessed in: n days OR after n date (if n < 1900 then n = n days, else n = YYYYMMDD date)"

)]

[int] $MaxLastAccessAge = -1,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Will shortly pause and retry when I/O errors occur during copying"

)]

[switch] $RecoveryMode,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Will stay active after copying, and copy additional changes after a a default threshold of 10 minutes"

)]

[switch] $MonitorMode,

################################################################################

[ValidateRange(1, 144000)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Run again in n minutes Time, if changed"

)]

[int] $MonitorModeThresholdMinutes = -1,

################################################################################

[ValidateRange(1, 1000000000)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Run again when more then n changes seen"

)]

[int] $MonitorModeThresholdNrOfChanges = -1,

################################################################################

[ValidateRange(0, 2359)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Run hours - times when new copies may be started, start-time, range 0000:2359"

)]

[int] $MonitorModeRunHoursFrom = -1,

################################################################################

[ValidateRange(0, 2359)]

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Run hours - times when new copies may be started, end-time, range 0000:2359"

)]

[int] $MonitorModeRunHoursUntil = -1,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "If specified, logging will also be done to specified file"

)]

[string] $LogFilePath,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Don't append to the specified logfile, but overwrite instead"

)]

[switch] $LogfileOverwrite,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Include all scanned directory names in output"

)]

[switch] $LogDirectoryNames,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Include all scanned file names in output, even skipped onces"

)]

[switch] $LogAllFileNames,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Output status as UNICODE"

)]

[switch] $Unicode,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Enables optimization for copying large files"

)]

[switch] $LargeFiles,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Optimize performance by doing multithreaded copying"

)]

[switch] $MultiThreaded,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "If applicable use compression when copying files between servers to safe bandwidth and time"

)]

[switch] $CompressibleContent,

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

ValueFromRemainingArguments = $true,

Position = 3,

HelpMessage = "Overrides, Removes, or Adds any specified robocopy parameter.

)]

[string] $Override,

################################################################################

################################################################################

[Parameter(

Mandatory = $false,

ValueFromPipeline = $false,

HelpMessage = "Displays a message that describes the effect of the command, instead of executing the command."

)]

[switch] $WhatIf

)

Begin {

#######################################################################################

# initialize settings

$RobocopyPath = "$env:SystemRoot\system32\robocopy.exe";

# normalize to current directory

$Source = ExpandPath($Source)

$DestinationDirectory = ExpandPath($DestinationDirectory);

# source is not an existing directory?

if ([IO.Directory]::Exists($Source) -eq $false) {

# split directory and filename

$SourceSearchMask = [IO.Path]::GetFileName($Source);

$SourceDirOnly = [IO.Path]::GetDirectoryName($Source);

# does parent directory exist?

if ([IO.Directory]::Exists($SourceDirOnly)) {

# ..but the supplied source parameter is not an existing file?

if ([IO.File]::Exists($Source) -eq $false) {

# ..and the supplied filename is not searchMask?

if (!$SourceSearchMask.Contains("*") -and !$SourceSearchMask.Contains("?")) {

throw "Could not find source: $Source"

}

}

$Mirror = $false;

}

# reconfigure

$Source = $SourceDirOnly;

if ($Files -notcontains $SourceSearchMask) {

$Files = $Files + @($SourceSearchMask);

}

}

# default value

if ($Files.Length -eq 0) {

$Files = @("*");

}

# destination directory does not exist yet?

if ([IO.Directory]::Exists($DestinationDirectory) -eq $false) {

# create it

[IO.Directory]::CreateDirectory($DestinationDirectory) | Out-Null

}

# Turn on verbose

$VerbosePreference = "Continue"

#######################################################################################

function ConstructFileFilterSet([string[]] $FileFilterSet, [string] $CommandName) {

$result = "";

$FileFilterSet | ForEach-Object {

$result = "$result '$PSItem'".Trim()

}

return $result;

}

function SanitizeAttributeSet([string] $AttributeSet, [string] $CommandName) {

$AttributeSetNew = "";

$AttributeSet.Replace("[", "").Replace("]", "").ToUpperInvariant().ToCharArray() | ForEach-Object {

if (("RASHCNETO".IndexOf($PSItem) -ge 0) -and ($AttributeSetNew.IndexOf($PSItem) -lt 0)) {

$AttributeSetNew = "$AttributeSet$PSItem";

}

else {

throw "Could not parse parameter -$CommandName $AttributeSet - '$PSIem' is not valid

}

}

return $AttributeSetNew

}

function CheckAgeInteger([int] $AgeValue, [string] $CommandName) {

if ($AgeValue -ge 1900) {

[DateTime] $date;

if ([DateTime]::TryParse("$MaxFileAge", [ref] $date) -eq $false) {

throw "Could not parse parameter '-$CommandName $AgeValue as a valid date (if n < 1900 then n = n days, else n = YYYYMMDD date)"

}

}

}

function getSwitchesDictionary([string] $Switches) {

# initialize

$switchesDictionary = New-Object "System.Collections.Generic.Dictionary[String, String]";

if ([String]::IsNullOrWhiteSpace($Switches)) {

return $switchesDictionary

}

$switchesCleaned = " $Switches ";

# remove spaces

while ($switchesCleaned.IndexOf(" /") -ge 0) {

$switchesCleaned = $switchesCleaned.Replace(" /", " /");

}

while ($switchesCleaned.IndexOf(" -/") -ge 0) {

$switchesCleaned = $switchesCleaned.Replace(" -/", " -/");

}

# split up

$allSwitches = $switchesCleaned.Replace(" -/", " /-").Split(" /", [System.StringSplitOptions]::RemoveEmptyEntries);

# enumerate switches

$allSwitches | ForEach-Object -ErrorAction SilentlyContinue {

# add to Dictionary

$switchesDictionary["$($PSItem.Trim().Split(" ")[0].Split(":" )[0].Trim().ToUpperInvariant())"] = $PSItem.Trim()

}

return $switchesDictionary;

}

function overrideAndCleanSwitches([string] $Switches) {

$autoGeneratedSwitches = (getSwitchesDictionary $Switches)

$overridenSwitches = (getSwitchesDictionary $Override)

$newSwitches = "";

$autoGeneratedSwitches.GetEnumerator() | ForEach-Object -ErrorAction SilentlyContinue {

# should NOT remove it?

if (!$overridenSwitches.ContainsKey("-$($PSItem.Key)")) {

# should replace it?

if ($overridenSwitches.ContainsKey($PSItem.Key)) {

$newSwitches += " /$($overridenSwitches[$PSItem.Key])"

}

else {

# keep the autogenerated switch

$newSwitches += " /$($PSItem.Value)"

}

}

}

$overridenSwitches.GetEnumerator() | ForEach-Object -ErrorAction SilentlyContinue {

# not already processed above?

if (!$PSItem.Key.StartsWith("-") -and !$autoGeneratedSwitches.ContainsKey("$($PSItem.Key)")) {

# add it

$newSwitches += " /$($PSItem.Value)"

}

}

return $newSwitches.Trim();

}

#######################################################################################

# /MOV █ MOVE files AND dirs (delete from source after copying).

$ParamMOV = "";

# /MIR █ MIRror a directory tree (equivalent to /E plus /PURGE).

$ParamMIR = "";

# /SECFIX █ FIX file SECurity on all files, even skipped files.

$ParamSECFIX = "";

# /E █  copy subdirectories, including Empty ones.

# /S █ copy Subdirectories, but not empty ones.

$ParamDirs = "/E"

# /COPY █ what to COPY for files (default is /COPY:DAT).

$ParamCOPY = "/COPY:DAT"

# /XO █ eXclude Older files.

$ParamXO = "/XO";

# /IM █  Include Modified files (differing change times).

$ParamIM = "/IM";

# /IT █ Include Tweaked files.

$ParamIT = "/IT";

# /IS █ Include Same files.

$ParamIS = "";

# /EFSRAW █  copy all encrypted files in EFS RAW mode.

$ParamEFSRAW = "";

# /NOOFFLOAD █  copy files without using the Windows Copy Offload mechanism.

$ParamNOOFFLOAD = "";

# /R █ number of Retries on failed copies: default 1 million.

$ParamR = "/R:0";

# /W █ Wait time between retries: default is 30 seconds.

$ParamW = "/W:0";

# /J █ copy using unbuffered I/O (recommended for large files).

$paramJ = "";

# /MT         █ Do multi-threaded copies with n threads (default 8).

$paramMT = "";

# /NDL █ No Directory List - don't log directory names.

$ParamNDL = "/NDL";

# /X █ report all eXtra files, not just those selected.

$ParamX = "";

# /V █  produce Verbose output, showing skipped files.

$ParamV = "";

# /CREATE █  CREATE directory tree and zero-length files only.

$ParamCREATE = "";

# /XJ █ eXclude symbolic links (for both files and directories) and Junction points.

$ParamXJ = "";

# /XJD █ eXclude symbolic links for Directories and Junction points.

$ParamXJD = "";

# /XJF █  eXclude symbolic links for Files.

$ParamXJF = "";

# /SJ █ copy Junctions as junctions instead of as the junction targets.

$ParamSJ = "";

# /SL █ copy Symbolic Links as links instead of as the link targets.

$ParamSL = "";

# /A █  copy only files with the Archive attribute set.

# /M █ copy only files with the Archive attribute and reset it.

$ParamArchive = "";

# /XF

$ParamXF = "" # █ eXclude Files matching given names/paths/wildcards.