COMMAND EVERYTHING.

New-DfsReplicatedFolder

Creates a replicated folder in a replication group.

PowerShell · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft DFSR reference: Creates a replicated folder in a replication group. 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.

New-DfsReplicatedFolder [-GroupName] <String[]> [-FolderName] <String[]> [[-Description] <String>]
 [[-FileNameToExclude] <String[]>] [[-DirectoryNameToExclude] <String[]>] [[-DfsnPath] <String>]
 [-CreateDisabledMemberships] [[-DomainName] <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for New-DfsReplicatedFolder. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / DFSR · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-Confirm: Prompts you for confirmation before running the cmdlet.
-CreateDisabledMemberships: Indicates that the any members that you add to the replicated folder have disabled memberships. You do not typically need to set this parameter, because the next step in creating a new replication topology is to create the connections and membership, and then start replication.
-Description: Specifies a description for the replicated folder.
-DfsnPath: Specifies the DFS Namespace (DFSN) folder path of the replicated folder. The DFSN folder path has no effect on replication. This property exists only as a descriptive convenience to administrators and DFS Replication service does not validate the value of this property.
-DirectoryNameToExclude: Specifies an array of names of subfolders that the DSFR service excludes and does not replicate in the replicated folder. You must provide only folder names, not full paths. You can use wildcards.
-DomainName: Specifies the NetBIOS name or fully qualified domain name (FQDN) for the Active Directory Domain Service (AD DS) domain that contains the replication group. If you do not specify this parameter, the cmdlet uses the domain of the current user.
-FileNameToExclude: Specifies an array of names and extensions of files that the Distributed File System (DSF) Replication service excludes and does not replicate in the replicated folder. Provide only folder names for this parameter. Do not specify full paths. You can use wildcards.
-FolderName (required): Specifies an array of names of replicated folders. You can use a comma separated list and the wildcard character (*). If you do not specify this parameter, the cmdlet gets all replicated folders.
-GroupName (required): Specifies an array of names of replication groups. You can use a comma separated list and the wildcard character (*).
-WhatIf: Shows what would happen if the cmdlet runs. The cmdlet is not run.

Prerequisites

Windows with the DFSR 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 cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Example 1: Create a replicated folder

New-DfsReplicatedFolder -GroupName "RG22" -FolderName "RF26"

This command creates a replicated folder named RF26 in the replication group named RG22. The command does not alter the default settings for a replicated folder. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/DFSR/New-DfsReplicatedFolder.md

https://learn.microsoft.com/powershell/module/dfsr/new-dfsreplicatedfolder?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands