Editorial review

Author: robinharwood

docset/winserver2022-ps/storagereplica/New-SRGroup.md

@@ -16,16 +16,15 @@ Creates a replication group.
 ## SYNTAX
 
 ```
-New-SRGroup [[-ComputerName] <String>] [-Name] <String> [-VolumeName] <String[]> [-LogVolumeName] <String>
- [[-LogSizeInBytes] <UInt64>] [[-Description] <String>] [-EnableConsistencyGroups] [-EnableEncryption]
- [-EnableCompression] [-Force] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
- [<CommonParameters>]
+New-SRGroup [[-ComputerName] <String>] [-Name] <String> [-VolumeName] <String[]> [-LogVolumeName]
+<String> [[-LogSizeInBytes] <UInt64>] [[-Description] <String>] [-EnableConsistencyGroups]
+[-EnableEncryption] [-EnableCompression] [-Force] [-CimSession <CimSession[]>]
+[-ThrottleLimit <Int32>] [-AsJob] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-The **New-SRGroup** cmdlet creates a replication group.
-A replication group contains one or more data volumes and an associated log volume.
-A replication group is the container for replication.
+The `New-SRGroup` cmdlet creates a replication group. A replication group contains one or more
+data volumes and an associated log volume. A replication group is the container for replication.
 
 > [!NOTE]
 > The **EnableCompression** parameter is currently in PREVIEW beginning with TODO: 2022-08
@@ -37,75 +36,40 @@ A replication group is the container for replication.
 ## EXAMPLES
 
 ### Example 1: Create a replication group
-```
-PS C:\>New-SRGroup -ComputerName "SR-SRV05" -Name "ReplicationGroup01" -VolumeName "D:" -LogVolumeName "E:" 
-AllowVolumeResize  : False
-AsyncRPO           : 
-ComputerName       : SR-SRV05
-Description        : 
-Id                 : 7b44e4bd-3fd8-411d-a6d1-1a6bb704520f
-IsAutoFailover     : 
-IsCluster          : False
-IsEncrypted        : False
-IsInPartnership    : False
-IsPrimary          : 
-IsSuspended        : 
-IsWriteConsistency : False
-LastInSyncTime     : 
-LogSizeInBytes     : 8589934592
-LogVolume          : e:\ 
-Name               : ReplicationGroup01
-NumOfReplicas      : 1
-Partitions         : {bc49f059-4f78-464d-b88a-3a092108816e}
-Replicas           : {MSFT_WvrReplica (PartitionId =
-                     "bc49f059-4f78-464d-b88a-3a092108816e")}
-ReplicationMode    : Synchronous
-ReplicationStatus  : NotInPartnership
-PSComputerName     :
+```powershell
+New-SRGroup -ComputerName "SR-SRV05" -Name "ReplicationGroup01" -VolumeName "D:" -LogVolumeName "E:" 
 ```
 
-This command creates a replication group for server named SR-SRV05.
-The command specifies the replicated volume and the log volume.
-Because this command does not specify other parameters, the replication group uses default values.
-Replication does not start until you run the New-SRPartnership cmdlet.
+This command creates a replication group for server named SR-SRV05. The command specifies the
+replicated volume and the log volume. Because this command does not specify other parameters, the
+replication group uses default values. Replication does not start until you run the
+`New-SRPartnership` cmdlet.
 
 ### Example 2: Create a replication group that uses custom properties
+```powershell
+$Parameters = @{
+    ComputerName = 'SR-SRV05'
+    Name = 'ReplicationGroup02'
+    VolumeName = 'D:'
+    LogVolumeName = 'E:'
+    LogSizeInBytes = '32GB'
+    EnableEncryption = $True
+}
+New-SRGroup @Parameters
 ```
-PS C:\>New-SRGroup -ComputerName "SR-SRV05" -Name "ReplicationGroup02" -VolumeName "D:" -LogVolumeName "E:" -LogSizeInBytes 32GB -EnableEncryption
-AllowVolumeResize  : False
-AsyncRPO           : 
-ComputerName       : SR-SRV05
-Description        : 
-Id                 : 1b0962d1-0771-49cb-bde5-7298db488263
-IsAutoFailover     : 
-IsCluster          : False
-IsEncrypted        : True
-IsInPartnership    : False
-IsPrimary          : 
-IsSuspended        : 
-IsWriteConsistency : False
-LastInSyncTime     : 
-LogSizeInBytes     : 34359738368
-LogVolume          : e:\ 
-Name               : ReplicationGroup02
-NumOfReplicas      : 1
-Partitions         : {bc49f059-4f78-464d-b88a-3a092108816e}
-Replicas           : {MSFT_WvrReplica (PartitionId =
-                     "bc49f059-4f78-464d-b88a-3a092108816e")}
-ReplicationMode    : Synchronous
-ReplicationStatus  : NotInPartnership
-PSComputerName     :
-```
 
-This command creates a replication group for server named SR-SRV05.
-The command specifies the replicated volume and the log volume.
-The command also specifies a custom log size in GB and enables replication traffic encryption.
-Replication does not start until you run **New-SRPartnership**.
+This command creates a replication group for server named SR-SRV05. The command specifies the
+replicated volume and the log volume. The command also specifies a custom log size in GB and enables
+replication traffic encryption. Replication does not start until you run **New-SRPartnership**.
+
+This example uses splatting to pass parameter values from the `$Parameters` variable to the command.
+Learn more about [Splatting](/powershell/module/microsoft.powershell.core/about/about_splatting).
 
 ## PARAMETERS
 
 ### -AsJob
-Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
+Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to
+complete.
 
 ```yaml
 Type: SwitchParameter
@@ -120,9 +84,10 @@ Accept wildcard characters: False
 ```
 
 ### -CimSession
-Runs the cmdlet in a remote session or on a remote computer.
-Enter a computer name or a session object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967) or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet.
-The default is the current session on the local computer.
+Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session
+object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967)
+or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966) cmdlet. The default is the
+current session on the local computer.
 
 ```yaml
 Type: CimSession[]
@@ -137,8 +102,8 @@ Accept wildcard characters: False
 ```
 
 ### -ComputerName
-Specifies a single replica host computer NetBIOS name or fully qualified domain name (FQDN) of a computer to belong to the replication group.
-The default value is the local computer.
+Specifies a single replica host computer NetBIOS name or fully qualified domain name (FQDN) of a
+computer to belong to the replication group. The default value is the local computer.
 
 ```yaml
 Type: String
@@ -183,9 +148,9 @@ Accept wildcard characters: False
 ```
 
 ### -EnableConsistencyGroups
-Indicates that consistency groups are enabled for the replication group that contains multiple volumes.
-Consistency groups provide write ordering.
-This can be important, for example, for replication of application data on multiple volumes.
+Indicates that consistency groups are enabled for the replication group that contains multiple
+volumes. Consistency groups provide write ordering. This can be important, for example, for
+replication of application data on multiple volumes.
 
 If you enable consistency groups, it may decrease replication and write Input/Output performance.
 
@@ -202,9 +167,9 @@ Accept wildcard characters: False
 ```
 
 ### -EnableEncryption
-Indicates that this partnership should encrypt connection by using SMB AES-128-GCM.
-Enabling encryption can protect Storage Replica block transfers from man-in-the-middle interception or reading.
-Enabling encryption decreases performance.
+Indicates that this partnership should encrypt connection by using SMB AES-128-GCM. Enabling
+encryption can protect Storage Replica block transfers from man-in-the-middle interception or
+reading. Enabling encryption decreases performance.
 
 ```yaml
 Type: SwitchParameter
@@ -234,11 +199,12 @@ Accept wildcard characters: False
 ```
 
 ### -LogSizeInBytes
-Specifies the aggregate size of log files on each server in the replication group for the volumes that are associated with this replication group.
-The minimum size 512MB.
-You can specify a value by using the Windows PowerShell byte conversion capability, such as 4GB or 3200MB.
+Specifies the aggregate size of log files on each server in the replication group for the volumes
+that are associated with this replication group. The minimum size 512MB. You can specify a value by
+using the Windows PowerShell byte conversion capability, such as 4GB or 3200MB.
 
-A value that is too small may cause decreased replication performance or increased recovery time after an interruption between computers.
+A value that is too small may cause decreased replication performance or increased recovery time
+after an interruption between computers.
 
 ```yaml
 Type: UInt64
@@ -253,10 +219,9 @@ Accept wildcard characters: False
 ```
 
 ### -LogVolumeName
-Specifies a drive letter, mount point path, or volume GUID where Storage Replication creates destination replication logs.
-The value must contain an NTFS-formatted volume or ReFS-formatted volume.
-The path must exist.
-The path cannot be a mapped drive or UNC path.
+Specifies a drive letter, mount point path, or volume GUID where Storage Replication creates
+destination replication logs. The value must contain an NTFS-formatted volume or ReFS-formatted
+volume. The path must exist. The path cannot be a mapped drive or UNC path.
 
 Storage Replication creates logs in the System Volume Information folder.
 
@@ -288,9 +253,11 @@ Accept wildcard characters: False
 ```
 
 ### -ThrottleLimit
-Specifies the maximum number of concurrent operations that can be established to run the cmdlet.
-If this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer.
-The throttle limit applies only to the current cmdlet, not to the session or to the computer.
+Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If
+this parameter is omitted or a value of `0` is entered, then Windows PowerShell® calculates an
+optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the
+computer. The throttle limit applies only to the current cmdlet, not to the session or to the
+computer.
 
 ```yaml
 Type: Int32
@@ -305,16 +272,14 @@ Accept wildcard characters: False
 ```
 
 ### -VolumeName
-Specifies an array of drive letters or mount point paths for the replica.
-The volumes must exist.
+Specifies an array of drive letters or mount point paths for the replica. The volumes must exist.
 The volumes cannot be mapped drives or UNC paths.
 
-This is an ordered list.
-The order of volumes determines the order of replication.
-For more information, see the *DestinationVolumeName* parameter of the New-SRPartnership cmdlet.
+This is an ordered list. The order of volumes determines the order of replication. For more
+information, see the **DestinationVolumeName** parameter of the `New-SRPartnership` cmdlet.
 
-We do not recommend replicating different drive letters or mount point paths.
-The practice can cause application failures because of stored settings after a failover occurs.
+We do not recommend replicating different drive letters or mount point paths. The practice can cause
+application failures because of stored settings after a failover occurs.
 
 ```yaml
 Type: String[]
@@ -329,7 +294,10 @@ Accept wildcard characters: False
 ```
 
 ### CommonParameters
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
+-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
+-WarningAction, and -WarningVariable. For more information, see
+[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
 
 ## INPUTS