Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

New-DfsReplicatedFolder

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

New-DfsReplicatedFolder

Creates a replicated folder in a replication group.

Syntax

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




Detailed Description

The New-DfsReplicatedFolder cmdlet creates a new replicated folder in a replication group. Replicated folders are logical arrangements of replication that do not contain computer-specific settings.

Parameters

-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.


Aliases

none

Required?

false

Position?

7

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Description<String>

Specifies a description for the replicated folder.


Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DfsnPath<String>

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.


Aliases

none

Required?

false

Position?

6

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DirectoryNameToExclude<String[]>

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.


Aliases

DirectoryFilter

Required?

false

Position?

5

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DomainName<String>

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.


Aliases

none

Required?

false

Position?

101

Default Value

[Current Domain]

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-FileNameToExclude<String[]>

Specifies an array of names and extensions of files that the DSFR 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.


Aliases

FileFilter

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FolderName<String[]>

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.


Aliases

RF,RfName

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-GroupName<String[]>

Specifies an array of names of replication groups. You can use a comma separated list and the wildcard character (*).


Aliases

RG,RgName

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Microsoft.DistributedFileSystemReplication.DfsReplicationGroup

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.DistributedFileSystemReplication.DfsReplicatedFolder

Examples

Example 1: Create a replicated folder

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.


PS C:\> New-DfsReplicatedFolder -GroupName "RG22" -FolderName "RF26"
              

GroupName : RG22
FolderName : RF26
DomainName : corp.contoso.com
Identifier : 434ca205-388d-4f24-a5b0-7ff875d433e0
Description :
FileNameToExclude : {~*, *.bak, *.tmp}
DirectoryNameToExclude : {}
DfsnPath :
IsDfsnPathPublished : False
State : Normal

Example 2: Create a replicated folder and add a DFS namespace link path

This command creates a replicated folder named RF26 in the replication group named RG22. The command DfsnPath parameter sets the administrative property for a DFS namespace link path. The cmdlet reminds the administrator that the DFSN path is cosmetic only and is not verified or used by DFS Replication in any way.


PS C:\> New-DfsReplicatedFolder -GroupName "RG22" -FolderName "RF26" -DfsnPath \\corp.contoso.com\public\link1
              

WARNING: The DfsnPath parameter is not validated. An incorrect path will not produce an error.


GroupName : RG22
FolderName : RF267
DomainName : corp.contoso.com
Identifier : 111c28cb-348a-47e3-8e4d-4bf394f640bb
Description :
FileNameToExclude : {~*, *.bak, *.tmp}
DirectoryNameToExclude : {}
DfsnPath : \\corp.contoso.com\public\link1
IsDfsnPathPublished : True
State : Normal

Example 3: Create a replicated folder that excludes specific file names

This command creates a replicated folder named RF08 in the replication group named RG11. The command specifies that the DFS Replication service exclude file names starting with a tilde (~) character and files that have the extensions .bak, .tmp, and .ned from replication.


PS C:\> New-DfsReplicatedFolder -GroupName "RG11" -FolderName "RF08" -FileNameToExclude "~*, *.bak, *.tmp, *.ned"
              

GroupName : RG11
FolderName : RF08
DomainName : corp.contoso.com
Identifier : 085a1de3-b4e5-46a4-a8f4-8f36a20bafdf
Description :
FileNameToExclude : {~*, *.bak, *.tmp, *.ned}
DirectoryNameToExclude : {}
DfsnPath :
IsDfsnPathPublished : False
State : Normal

Example 4: Create a data distribution replication topology

This example creates a hub and spoke data distribution replication topology.


 

The first command uses the New-DfsReplicationGroup cmdlet to create a replication group object named Branch Office 1, and passes the object to the New-DfsReplicatedFolder cmdlet by using the pipe operator. The New-DfsReplicatedFolder cmdlet creates a replication folder object named Data Distribution 1, and passes the object to the Add-DfsrMember cmdlet by using the pipe operator. The Add-DfsrMember cmdlet adds the computers named SRV01, SRV02, and SRV03 to the replication group named Branch Office 1.


PS C:\> New-DfsReplicationGroup -GroupName "Branch Office 1" | New-DfsReplicatedFolder -FolderName "Data Distribution 1" | Add-DfsrMember -ComputerName "SRV01","SRV02","SRV03" | Format-Table dnsname,groupname -auto -wrap
                
DnsName GroupName
------- ---------
SRV01.corp.contoso.com Branch Office 1
SRV02.corp.contoso.com Branch Office 1
SRV03.corp.contoso.com Branch Office 1

 

The second command creates a bidirectional replication connection between the computer named SRV01 and the computer named SRV02 in the replication group named Branch Office 1.


PS C:\> Add-DfsrConnection -GroupName "Branch Office 1" -SourceComputerName SRV01 -DestinationComputerName SRV02 | Format-Table *name -wrap -auto
                


GroupName SourceComputerName DestinationComputerName
--------- ------------------ -----------------------
Branch Office 1 SRV01 SRV02
Branch Office 1 SRV02 SRV01

 

The third command creates a bidirectional replication connection between the computer named SRV01 and the computer named SRV03 in the replication group named Branch Office 1.


PS C:\> Add-DfsrConnection -GroupName "Branch Office 1" -SourceComputerName SRV01 -DestinationComputerName SRV03 | Format-Table *name -wrap -auto
GroupName       SourceComputerName DestinationComputerName
--------- ------------------ -----------------------
Branch Office 1 SRV01 SRV03
Branch Office 1 SRV03 SRV01

 

The fourth command uses the Set-DfsrMembership cmdlet to configure membership settings for the primary member of the replication group named Branch Office 1. The command specifies that the computer named SRV01 is the primary member of the group. The command sets an appropriate quota size of the staging folder instead of the lower default.


PS C:\> Set-DfsrMembership -GroupName "Branch Office 1" -FolderName "Data Distribution 1" -ContentPath c:\rf1 -ComputerName SRV01 -PrimaryMember $True -StagingPathQuotaInMB 16384 -Force | Format-Table *name,*path,primary* -auto -wrap
                

DomainName GroupName FolderName ComputerName ContentPath StagingPath PrimaryMember
---------- --------- ---------- ------------ ----------- ----------- -------------
corp.contoso.com Branch Office 1 Data Distribution 1 SRV01 c:\rf1 c:\rf1\DfsrPrivate\Staging True

 

The last command uses the Set-DfsrMembership cmdlet to configure membership settings for the members of the replication group named Branch Office 1. The command specifies that the computers named SRV02 and SRV03 are members of the group. The command sets an appropriate quota size of the staging folder instead of the lower default.


PS C:\> Set-DfsrMembership -GroupName "Branch Office 1" -FolderName "Data Distribution 1" -ContentPath c:\rf1 -ComputerName SRV02,SRV03 -StagingPathQuotaInMB 16384 -Force | Format-Table *name,*path,primary* -auto -wrap
                

DomainName GroupName FolderName ComputerName ContentPath StagingPath PrimaryMember
---------- --------- ---------- ------------ ----------- ----------- -------------
corp.contoso.com Branch Office 1 Data Distribution 1 SRV02 c:\rf1 c:\rf1\DfsrPrivate\Staging False
corp.contoso.com Branch Office 1 Data Distribution 1 SRV03 c:\rf1 c:\rf1\DfsrPrivate\Staging False

Related topics

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.