Smart Solutions
Need help?
  • 100% Free & MIT Licensed
  • No third-party data hosting
SharePoint MigrationPnP PowerShellComparison

Smart Copy vs PnP PowerShell for copying SharePoint content

8 min readBy Offered as a service by our team

Every SharePoint admin has the same first instinct when asked to move content: open PnP PowerShell and pipe Copy-PnPFile at it. It's free, it's already installed, and for a folder of 20 files it works exactly as advertised. The problem is that "20 files" and "a real document library" behave completely differently, and the failure modes only show up at scale.

This post is an honest side-by-side of PnP PowerShell against the free open-source SharePoint Smart Copy app. Both are free. Both run against SharePoint Online. They fail in very different places.

Where PnP PowerShell breaks down

1. Timeouts on long-running jobs

Copy-PnPFolder and Copy-PnPFile ultimately call CSOM or Microsoft Graph. Both have request timeouts (typically 30 minutes for the Graph copy operation, shorter for CSOM). A single library of a few thousand versioned files routinely exceeds that. The script throws a ServerException, PowerShell exits, and you're left guessing which files landed and which didn't. Retries have to be rebuilt by hand — usually a second script that diffs source and target and re-runs the delta.

2. Version-history metadata quietly collapses

This is the one that catches people out. Copy-PnPFile copies the current version's bytes cleanly, but prior-version metadata is where the gaps are: the original author on version 3, the check-in comment on version 5, the exact timestamp on version 7 — many of these come across stamped with the account that ran the script and the current time. If you're moving files for an audit or a legal hold, that's not "preserved" version history, that's fabricated version history.

3. No per-file reporting

PowerShell gives you a stream of exceptions in the console. There is no built-in per-file report of what copied, what skipped, what failed and why. On a 5,000-file library, reconstructing that from a scrollback buffer is a job in itself.

4. Throttling handling is your problem

SharePoint Online will throttle any script that hammers it. PnP handles some 429s automatically, but not all — long copy jobs still hit hard-stop throttles and you'll need to add your own Start-Sleeplogic and exponential backoff.

Side-by-side

CapabilityPnP PowerShellSmart Copy
CostFreeFree (MIT)
Handles 5,000+ file libraries in one jobProne to timeoutChunked with retry
Preserves original author on prior versionsUnreliableYes
Preserves check-in comments per versionUnreliableYes
Preserves original timestamps per versionUnreliableYes
Copies item-level permissionsManual — extra scriptCheckbox
Per-file success / failure reportNo (console only)Exportable to Excel
Automatic 429 / throttle backoffPartialBuilt-in
Resume from failureDIY — diff and re-runDelta-copy from report
Independent post-copy verificationDIY — write another scriptVerify button → Excel workbook (hash, date, optional Deep Verify)
Ideal batch sizeDozensWhole libraries / sites

When PowerShell is still the right tool

  • Twenty files between two folders, one-off.
  • Fully automated pipelines where you already own the retry, logging, and reporting layer.
  • Copies that don't touch version history at all — a single-version file into a fresh library.

When to reach for Smart Copy instead

  • Any move over a few hundred versioned files.
  • Anything with audit / compliance / legal-hold implications — the version-history metadata has to be intact.
  • Anything where you'll be asked "what got copied?" — the exportable report is the answer.
  • Anything where the copy needs to include item-level permissions.

Related

Free · MIT license · no sign-up

Get your first result in about 10 minutes

Copy sites, libraries, lists and pages with full version history. Free, MIT licensed, no sign-up.

  1. Download the Windows app from the latest release.
  2. Run it and sign in to your Microsoft 365 tenant.
  3. Pick a source and target site, then copy.
Install guide
Download the latest releaseView on GitHub
Email me when a new release ships
Get notified when SharePoint Smart Copy updates

No marketing spam. One short email when a new release ships. You can unsubscribe anytime.

Was this page helpful?

One click. No form, no email address.

Missing something in SharePoint Smart Copy? Feature requests and bug reports go straight to the developer on GitHub — no account needed to read, free account to post.

Request a feature

Related tool

SharePoint Smart Copy

Copy sites, libraries, lists and pages with full version history. Free, MIT licensed, no sign-up.

Want our team to do it for you? If you would rather not run this yourself, our team can plan and run your migration using the free tools on this site. You get hands-on help and no software license to buy. Talk to us

About the author

Sean Regan

SharePoint & Microsoft 365 consultant with 20+ years of hands-on experience building SPFx web parts, migration tooling and tenant-grade automation. Maintainer of the open-source SharePoint Smart Solutions suite.