FileShareMigrationTools

1.1.1

Helper functions for exporting and recreating SMB file shares during file server migration or DFS preparation. Exports shares and share permissions from a source server, optionally remaps paths, and recreates shares and permissions on a target server with preview-by-default safety.

Minimum PowerShell version

5.1

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name FileShareMigrationTools

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name FileShareMigrationTools

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2026 Marcus Tedde. All rights reserved.

Package Details

Author(s)

  • Marcus Tedde

Tags

SMB FileShare Migration DFS Windows FileServer

Functions

Test-FSMAdminShareAccess Export-FSMShareInventory Export-FSMSharePermissions Convert-FSMSharePath New-FSMTargetShares Grant-FSMTargetSharePermissions Compare-FSMShareInventory Invoke-FSMShareMigrationPrep

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

v1.1.1 - Bug fixes: (1) New-FSMTargetShares and Grant-FSMTargetSharePermissions failed with "Cannot convert String to Boolean" on the remote Execute parameter - an unparenthesised [bool]$Execute in argument mode was read as the literal string "[bool]False" instead of a cast (also stopped preview mode silently making changes on PowerShell 7); casts are now parenthesised. (2) Show-FSMResultSummary threw under StrictMode whenever there were no Failed items (the common happy path), crashing Invoke-FSMShareMigrationPrep at the summary step; the Failed tally is now StrictMode-safe. (3) Convert-FSMSharePath no longer mis-remaps paths that merely share a prefix with OldRoot (e.g. D:\Shares no longer matches D:\SharesArchive); the root must end at a path boundary. Added regression tests for all three.
v1.1.0 - Restructured into Public/Private. Fixed empty-result and CSV-column crashes, added per-item error handling, safe boolean parsing, -Credential support, clustered ScopeName support, colour-coded summaries and optional logging.

FileList

Version History

Version Downloads Last updated
1.1.1 (current version) 7 5/29/2026
1.1.0 4 5/29/2026