This function contains pretty much everything about dfs-r groups. When you create a replication group from the GUI, have you ever noticed the steps that complete on the page after you click create? Ever paid any attention to what they are actually doing? Me neither, until I started looking at this new-dfsrgroup function. Assuming that there are 2 members to the replication group and all parameters have been entered, my function calls dfsradmin no less that 9 times to complete the task.
So how can we use the function? here are some examples....
new-dfsrgroup -name "rg2" -description "desc1" -Servers server1,server2 -folderpath e:\data\users -foldername Users
This command will invoke every part of the function and create a fully meshed replication group. Out of the parameters presented, only name and servers are mandatory. If you were to omit foldername eg :
new-dfsrgroup -name "rg2" -description "desc1" -Servers server1,server2 -folderpath e:\data\users
then the group will be created and the server will be added as members and connections will be created, but as there is no replication folder, members cannot be enabled. Essentially, the folderpath parameter in this example is ignored. If you were to keep the foldername and omit the folderpath :
new-dfsrgroup -name "rg2" -description "desc1" -Servers server1,server2 -foldername Users
then in addition to above a replication folder will be created, but still the members will not be enabled as no folderpath was supplied.
I could go on and on as this function has 10 possible parameters. You can control pretty much anything to do with the replication group creation.
This is straight out of the help file for the function :
Mandatory - The name of the Group to create
Optional - A description of the group
Mandatory - The servers that will be members in the group. The
first server in the list will be the primary server
Optional - The path to replicate. If not included, the group will
be created but replication not enabled
Optional - The name of the folder to appear in the group.
If not included, the group will be created but replication not enabled
Optional - The size of the staging area - defaults to 4Gb
Optional - The path to the staging area - defaults to within the folder
Optional - The size of the Conflict and Deleted folder - default to 350mb
Optional - The file types to exclude from replication eg "*.txt,*.tmp"
Optional - The subfolders to exclude from replication
You can download the module that contains this function here
I hope it helps dfs-r management, ask any questions in the comments!