New-DfsReplicatedFolder

적용 대상: Windows 10, Windows Server Technical Preview

New-DfsReplicatedFolder

Creates a replicated folder in a replication group.

구문

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




자세한 설명

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.

매개 변수

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


별칭

none

필수 여부

false

위치

7

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-Description<String>

Specifies a description for the replicated folder.


별칭

none

필수 여부

false

위치

3

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

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.


별칭

none

필수 여부

false

위치

6

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

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.


별칭

DirectoryFilter

필수 여부

false

위치

5

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

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.


별칭

none

필수 여부

false

위치

101

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-FileNameToExclude<String[]>

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.


별칭

FileFilter

필수 여부

false

위치

4

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

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.


별칭

RF,RfName

필수 여부

true

위치

2

기본값

none

파이프라인 입력 허용 여부

true(ByPropertyName)

와일드카드 문자 허용 여부

false

-GroupName<String[]>

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


별칭

RG,RgName

필수 여부

true

위치

1

기본값

none

파이프라인 입력 허용 여부

true(ByValue,ByPropertyName)

와일드카드 문자 허용 여부

false

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.


필수 여부

false

위치

named

기본값

false

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-WhatIf

cmdlet이 실행되는 경우 발생할 결과를 보여 줍니다. cmdlet은 실행되지 않습니다.


필수 여부

false

위치

named

기본값

false

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

  • Microsoft.DistributedFileSystemReplication.DfsReplicationGroup

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

  • Microsoft.DistributedFileSystemReplication.DfsReplicatedFolder

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"

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"

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"

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

 

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

 

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

 

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

 

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

관련 항목

커뮤니티 추가 항목

추가
표시: