# Purpose: this PowerShell snippet is to demonstrate the use of Emcopy

$source="C:\Users\tester\Desktop\Clients"
$destination="C:\Users\tester\Desktop\Test"
#$switches="/o /secforce /s /de /sd /c /r:0 /th 32 /cm md5 /purge /sdd"
$switches="/o /secforce /de /sd /c /r:0 /th 32 /s /purge /sdd"
    <# Switch explanations
    /s copies sub directories
    /purge removes files and directories from the destination that do not exist in the source.
    /sdd forces the target directories dates to be synchronized with the source directory.
    /de Compares both file size and last modification time when deciding to update a file, updates it if either have been changed.
    /cm md5 - checks the file content after copying using and md5 comparison of the source and destination.
    /o copies the files owner, without this the account used for the copy will be the owner
    /secforce overwrites the destination security settings with the source security settings (copies security settings)
    /sd preserves security, the file isn't copied if an error occurs during security settings.
    /th 32 - Uses 32 threads, default is 64
    /r:0 retries zero times
    /w:0 is the wait time in seconds between retries
    /c will allow the process to continue after the retries
    /log:filename option allows to redirect the console messages to a new file.
    /log+:filename option appends the new messages to an existing file.
    #>

$dateStamp = Get-Date -Format "yyyy-MM-dd-hhmmss"
$scriptName=$MyInvocation.MyCommand.Path
$scriptPath=Split-Path -Path $scriptName
$logPath="$scriptPath\emcopy_logs"
$logFile="$logPath\robocopy-log-$dateStamp.txt"
$log=" /LOG+:$logFile"


# Get the ID and security principal of the current user account
$myWindowsID=[System.Security.Principal.WindowsIdentity]::GetCurrent()
$myWindowsPrincipal=new-object System.Security.Principal.WindowsPrincipal($myWindowsID)
 
# Get the security principal for the Administrator role
$adminRole=[System.Security.Principal.WindowsBuiltInRole]::Administrator
 
# Check to see if we are currently running "as Administrator"
if ($myWindowsPrincipal.IsInRole($adminRole))
    {
    # We are running "as Administrator" - so change the title and background color to indicate this
    $Host.UI.RawUI.WindowTitle = $myInvocation.MyCommand.Definition + "(Elevated)"
    $Host.UI.RawUI.BackgroundColor = "Black"
    clear-host
    }
else
    {
    "Relaunching as an Administrator.";
   
    # Create a new process object that starts PowerShell
    $newProcess = new-object System.Diagnostics.ProcessStartInfo "PowerShell";
   
    # Specify the current script path and name as a parameter
    $newProcess.Arguments = $myInvocation.MyCommand.Definition;
   
    # Indicate that the process should be elevated
    $newProcess.Verb = "runas";
   
    # Start the new process
    [System.Diagnostics.Process]::Start($newProcess);
   
    # Exit from the current, unelevated, process
    exit
    }
 
# Run your code that needs to be elevated here
Write-Host -NoNewLine "Running as Administrator..."
#$null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")

function installEmcopy{
    $emcopyIsInstalled=(Get-Command emcopy.exe -ErrorAction SilentlyContinue) # Deterministic check on whether emcopy is already available on this system
    if (!($emcopyIsInstalled)){
        $tempDir="C:\Temp";
        $extractionDir="C:\Windows"
        $source = "https://blog.kimconnect.com/wp-content/uploads/2019/08/emcopy.zip";
        $destinationFile = "$tempDir\emcopy.zip";
        [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
        New-Item -ItemType Directory -Force -Path $tempDir
        New-Item -ItemType Directory -Force -Path $extractionDir
        $webclient = New-Object System.Net.WebClient;
        $WebClient.DownloadFile($source,$destinationFile);
        # Expand-Archive -LiteralPath $destinationFile -DestinationPath $extractionDir
# Using dot net library to extract file - backward compatible with legacy PowerShell
Add-Type -assembly "system.io.compression.filesystem"
[io.compression.zipfile]::ExtractToDirectory($destinationFile, $extractionDir)

}else{
"EMCOPY is currently available in this system.`n";
} 
}

function startEmcopy{
New-Item -ItemType Directory -Force -Path $logPath;
"Confirm this statement:`nemcopy64.exe $source $destination $switches $log";
pause;
invoke-expression "emcopy64.exe $source $destination $switches $log"
"emcopy process is finished. Log is generated here: $log"
pause;
}

installEmcopy;
startEmcopy;

A typical error:

TH000 : 20:32:21 : WARNING : Unable to retrieve the PDC of the domain intranet nearby \\FILESHERVER007, error : 1210
TH000 : 20:32:21 : WARNING : The default primary group is set to "domain users"

Resolution:

  • Identify the user account used for running EMCopy (admin account you are using)
  • Add that account to the local administrator group and local backup group on the Windows file server
  • Allow that account to “run as root” on the Isilon share
Categories: