Set-SRNetworkConstraint
Creates or modifies a replication network constraint for servers and partnerships.
Syntax
Set-SRNetworkConstraint
[[-SourceComputerName] <String>]
[[-SourceRGName] <String>]
[-SourceNWInterface] <String[]>
[[-DestinationComputerName] <String>]
[[-DestinationRGName] <String>]
[-DestinationNWInterface] <String[]>
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>] Description
The Set-SRNetworkConstraint cmdlet creates or modifies a replication network constraint for servers and partnerships. You can apply network constraints to one or more network adapter interfaces, in order to control which networks Storage Replica can use. Any networks not specified by this cmdlet are no longer used by Storage Replica.
Examples
Example 1: Set a constraint for stand-alone computers
The first command sets the network constraint for interfaces and replication groups. The final command makes sure that the constraint takes effect immediately by using the Update-SmbMultichannelConnection cmdlet.
Set-SRNetworkConstraint -SourceComputerName "SR-SRV06" -SourceRGName "ReplicationGroup02" -SourceNWInterface 6 -DestinationComputerName "SR-SRV05" -DestinationRGName "ReplicationGroup01" -DestinationNWInterface 2
Update-SmbMultichannelConnectionThis example sets the network constraint for interfaces and replication groups on stand-alone computers.
Example 2: Set a constraint for a stretch cluster
Set-SRNetworkConstraint -SourceComputerName "Cluster01" -SourceRGName "Group01" -SourceNWInterface "Cluster Network 1","Cluster Network 2" -DestinationComputerName "Cluster02" -DestinationRGName "Group02" -DestinationNWInterface "Cluster Network 1","Cluster Network 2"This command sets a network constraint for a specific set of cluster networks in a stretch cluster.
Parameters
-AsJob
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 or Get-CimSession cmdlet. The default is the current session on the local computer.
| Type: | CimSession[] |
| Aliases: | Session |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationComputerName
Specifies a single replica host computer NetBIOS name or fully qualified domain name (FQDN) of the destination computer.
| Type: | String |
| Aliases: | DCN |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DestinationNWInterface
Specifies an array of network interfaces. Specify the interfaces for Storage Replica to use. Other interfaces no longer accept Storage Replica traffic.
You can display these interfaces by using the Get-NetIPConfiguration cmdlet for stand-alone servers and the Get-ClusterNetwork cmdlet on failover clusters.
| Type: | String[] |
| Aliases: | DNI |
| Position: | 5 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DestinationRGName
Specifies the name of the destination replication group.
| Type: | String |
| Aliases: | DGN |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceComputerName
Specifies a single replica host computer NetBIOS name or FQDN of the source computer.
| Type: | String |
| Aliases: | SCN |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceNWInterface
Specifies an array of network interfaces. Specify the interfaces for Storage Replica to use. Other interfaces no longer accept Storage Replica traffic.
You can display these interfaces by using Get-NetIPConfiguration and Get-ClusterNetwork.
| Type: | String[] |
| Aliases: | SNI |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SourceRGName
Specifies the name of the source replication group.
| Type: | String |
| Aliases: | SGN |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |