New-DfsReplicationGroup
New-DfsReplicationGroup
Creates a replication group.
Syntax
Parameter Set: Default
New-DfsReplicationGroup [-GroupName] <String[]> [[-Description] <String> ] [[-DomainName] <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detaillierte Beschreibung
The New-DfsReplicationGroup cmdlet creates a replication group. A replication group is a set of servers, or members, that participate in the replication of one or more folders. A replicated folder is kept synchronized among the members of a replication group. This cmdlet cannot modify resource group bandwidth or schedules.
Parameter
-Description<String>
Specifies a description for the replication group.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
2 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-DomainName<String>
Specifies a NetBIOS or fully qualified domain name (FQDN) for the Active Directory domain that contains a replication group. If you do not specify this parameter, the cmdlet uses the current domain.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
101 |
Standardwert |
[Current Domain] |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-GroupName<String[]>
Specifies an array of names of replication groups.
Aliasse |
RG,RgName |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Confirm
Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.
Erforderlich? |
false |
Position? |
named |
Standardwert |
falsch |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Erforderlich? |
false |
Position? |
named |
Standardwert |
falsch |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.
- Microsoft.DistributedFileSystemReplication.DfsReplicationGroup
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
- Microsoft.DistributedFileSystemReplication.DfsReplicationGroup
Beispiele
Example 1: Create a replication group
This command creates a replication group named RG01.
PS C:\> New-DfsReplicationGroup -GroupName "RG01"
Example 2: Create a replication topology
This example creates a replication topology with an upstream server and two downstream servers.
The first command uses the New-DfsReplicationGroup cmdlet to create a replication group with the name Branch Office 1. The command pipes the output to the New-DfsReplicatedFolder cmdlet to create a replicated folder with the name Data Distribution 1. The command pipes the output to the Add-DfsrMember cmdlet to add the member servers named SRV01, SRV02, and SRV03. The command formats the output of the pipeline as a table.
The second command uses the Add-DfsrConnection cmdlet to add bidirectional connections between servers SRV01 and SRV02.
The third command uses the Add-DfsrConnection cmdlet to add bidirectional connections between servers SRV01 and SRV03.
The fourth command uses the Set-DfsrMembership cmdlet to set SRV01 as the primary member.
The fifth command uses the Set-DfsrMembership cmdlet to set membership for servers SRV02 and SRV03.
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
PS C:\> Add-DfsrConnection -GroupName "Branch Office 1" -SourceComputerName SRV01 -DestinationComputerName SRV02 | Format-Table *name -wrap -auto
PS C:\> Add-DfsrConnection -GroupName "Branch Office 1" -SourceComputerName SRV01 -DestinationComputerName SRV03 | Format-Table *name -wrap -auto
PS C:\> Set-DfsrMembership -GroupName "Branch Office 1" -FolderName "Data Distribution 1" -ContentPath c:\Rf01 -ComputerName SRV01 -PrimaryMember $True -StagingPathQuotaInMB 16384 -Force | Format-Table *name,*path,primary* -auto -wrap
PS C:\> Set-DfsrMembership -GroupName "Branch Office 1" -FolderName "Data Distribution 1" -ContentPath c:\Rf01 -ComputerName SRV02,SRV03 -StagingPathQuotaInMB 16384 -Force | Format-Table *name,*path,primary* -auto -wrap