@@ -18,11 +18,12 @@ Creates a replication group.
1818```
1919New-SRGroup [[-ComputerName] <String>] [-Name] <String> [-VolumeName] <String[]> [-LogVolumeName]
2020<String> [[-LogSizeInBytes] <UInt64>] [[-Description] <String>] [-EnableConsistencyGroups]
21- [-EnableEncryption] [-EnableCompression] [-Force] [-CimSession <CimSession[]>]
22- [-ThrottleLimit <Int32>] [-AsJob] [<CommonParameters>]
21+ [-EnableEncryption] [-EnableCompression] [-Force] [-CimSession <CimSession[]>]
22+ [-ThrottleLimit <Int32>] [-AsJob] [<CommonParameters>]
2323```
2424
2525## DESCRIPTION
26+
2627The ` New-SRGroup ` cmdlet creates a replication group. A replication group contains one or more
2728data volumes and an associated log volume. A replication group is the container for replication.
2829
@@ -36,6 +37,7 @@ data volumes and an associated log volume. A replication group is the container
3637## EXAMPLES
3738
3839### Example 1: Create a replication group
40+
3941``` powershell
4042New-SRGroup -ComputerName "SR-SRV05" -Name "ReplicationGroup01" -VolumeName "D:" -LogVolumeName "E:"
4143```
@@ -46,6 +48,7 @@ replication group uses default values. Replication will not start until you run
4648` New-SRPartnership ` cmdlet.
4749
4850### Example 2: Create a replication group that uses custom properties
51+
4952``` powershell
5053$Parameters = @{
5154 ComputerName = 'SR-SRV05'
@@ -68,6 +71,7 @@ Learn more about [Splatting](/powershell/module/microsoft.powershell.core/about/
6871## PARAMETERS
6972
7073### -AsJob
74+
7175Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to
7276complete.
7377
@@ -84,6 +88,7 @@ Accept wildcard characters: False
8488` ` `
8589
8690### -CimSession
91+
8792Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session
8893object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967)
8994or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet. The default is the
@@ -102,6 +107,7 @@ Accept wildcard characters: False
102107` ` `
103108
104109### -ComputerName
110+
105111Specifies a single replica host computer NetBIOS name or fully qualified domain name (FQDN) of a
106112computer to belong to the replication group. The default value is the local computer.
107113
@@ -118,6 +124,7 @@ Accept wildcard characters: False
118124` ` `
119125
120126### -Description
127+
121128Specifies a description for the replication group.
122129
123130` ` ` yaml
@@ -133,6 +140,7 @@ Accept wildcard characters: False
133140` ` `
134141
135142### -EnableCompression
143+
136144Indicates that this Storage Replica group should use SMB compression for data transfer. This
137145parameter only applies to
138146[Azure Stack HCI version 22H2](https://azure.microsoft.com/en-us/updates/public-preview-azure-stack-hci-version-22h2/)
@@ -152,6 +160,7 @@ Accept wildcard characters: False
152160` ` `
153161
154162### -EnableConsistencyGroups
163+
155164Indicates that consistency groups are enabled for the replication group that contains multiple
156165volumes. Consistency groups provide write ordering. This can be important, for example, for
157166replication of application data on multiple volumes.
@@ -171,6 +180,7 @@ Accept wildcard characters: False
171180` ` `
172181
173182### -EnableEncryption
183+
174184Indicates that this partnership should encrypt connection by using SMB AES-128-GCM. Enabling
175185encryption can protect Storage Replica block transfers from man-in-the-middle interception or
176186reading. Enabling encryption decreases performance.
@@ -188,6 +198,7 @@ Accept wildcard characters: False
188198` ` `
189199
190200### -Force
201+
191202Forces the command to run without asking for user confirmation.
192203
193204` ` ` yaml
@@ -203,6 +214,7 @@ Accept wildcard characters: False
203214` ` `
204215
205216### -LogSizeInBytes
217+
206218Specifies the aggregate size of log files on each server in the replication group for the volumes
207219that are associated with this replication group. The minimum size 512MB. You can specify a value by
208220using the Windows PowerShell byte conversion capability, such as 4GB or 3200MB.
@@ -223,6 +235,7 @@ Accept wildcard characters: False
223235` ` `
224236
225237### -LogVolumeName
238+
226239Specifies a drive letter, mount point path, or volume GUID where Storage Replication creates
227240destination replication logs. The value must contain an NTFS-formatted volume or ReFS-formatted
228241volume. The path must exist. The path cannot be a mapped drive or UNC path.
@@ -242,6 +255,7 @@ Accept wildcard characters: False
242255` ` `
243256
244257### -Name
258+
245259Specifies a name for the replication group.
246260
247261` ` ` yaml
@@ -257,6 +271,7 @@ Accept wildcard characters: False
257271` ` `
258272
259273### -ThrottleLimit
274+
260275Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If
261276this parameter is omitted or a value of ` 0` is entered, then Windows PowerShell® calculates an
262277optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the
@@ -276,6 +291,7 @@ Accept wildcard characters: False
276291` ` `
277292
278293# ## -VolumeName
294+
279295Specifies an array of drive letters or mount point paths for the replica. The volumes must exist.
280296The volumes cannot be mapped drives or UNC paths.
281297
@@ -298,6 +314,7 @@ Accept wildcard characters: False
298314` ` `
299315
300316# ## CommonParameters
317+
301318This cmdlet supports the common parameters : -Debug, -ErrorAction, -ErrorVariable,
302319-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
303320-WarningAction, and -WarningVariable. For more information, see
@@ -324,4 +341,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
324341[Suspend-SRGroup](./Suspend-SRGroup.md)
325342
326343[Sync-SRGroup](./Sync-SRGroup.md)
327-
0 commit comments