Windows Server · Risk: Low · Documentation Verified
Last verified: 2026-10-26
Microsoft StorageReplica reference: Validates a potential replication partnership. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.
Use an account with the target resource permissions documented for Test-SRTopology. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.
Supported environments
Windows / StorageReplica · Windows Server 2025 documentation; feature/module prerequisites apply
Parameters
-DataPath (required)
Specifies a path of the raw report files created on Nano Server with a previous run of this cmdlet. This parameter is only required to finish generation of reports created on a Nano Server, which do not contain the HTML chart generation controls. Specify a path of the files created in the *ResultPath* parameter.
-DestinationComputerName (required)
Specifies a single replica host computer NetBIOS name or fully qualified domain name (FQDN) for the destination computer.
-DestinationLogVolumeName (required)
Specifies a drive letter, mount point path, or volume GUID where destination replication logs would be created. The volume must contain an NTFS-formatted volume or ReFS-formatted volume. The path must exist. The path cannot be a mapped drive or UNC path.
-DestinationVolumeName (required)
Specifies an array of drive letters or mount point paths of the partitions for the replica. The volume must exist. The volume cannot be a mapped drive or UNC path.
-DurationInMinutes (required)
Specifies the number of minutes to run this cmdlet. This number is halved for initial sync testing and ongoing replication testing. This cmdlet creates a 100MB test file during these tests and then removes it at the completion of the tests.
-GenerateReport (required)
Indicates that this cmdlet converts the raw outputs into a readable HTML file. This parameter is only required for a Nano Server, which does not contain the HTML chart generation controls.
-IgnorePerfTests
Indicates that this cmdlet only checks requirements. It does not calculate performance numbers.
-ResultPath (required)
Specifies the output path for the measurement files and the finished HTML report.
-SourceComputerName (required)
Specifies a single replica host computer NetBIOS name or FQDN for the source computer. The default value is uses the local computer.
-SourceLogVolumeName (required)
Specifies a drive letter, mount point path, or volume GUID where source replication logs would be created. The volume must contain an NTFS-formatted volume or ReFS-formatted volume. The path must exist. The path cannot be a mapped drive or UNC path.
-SourceVolumeName (required)
Specifies an array of drive letters or mount point paths of the partitions for the replica. The volume must exist. The volume cannot be a mapped drive or UNC path.
Prerequisites
Windows with the StorageReplica module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.
Security considerations
This is a read-oriented cmdlet; protect any sensitive results and check the documented effects of your selected parameters.
This command creates a report that validates the requirements. It does not check performance. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.