Stop-NlbCluster

Stops all nodes of a Network Load Balancing (NLB) cluster.

Syntax

Stop-NlbCluster
    [[-HostName] <String>]
    [[-InterfaceName] <String>]
    [-Drain]
    [-Timeout <Nullable>]
Stop-NlbCluster
    [-Drain]
    [-Timeout <Nullable>]
    -InputObject <Cluster>

Description

The Stop-NlbCluster cmdlet stops all nodes in a Network Load Balancing (NLB) cluster. The cmdlet will stop the NLB service on the host and all existing connections will be lost. To avoid interrupting active connections, use the Drain parameter which allows the host to continue servicing active connections, but disables all new traffic to that host.

Examples

EXAMPLE 1

PS C:\>Stop-NlbCluster
Name                IPAddress           SubnetMask          Mode 
----                ---------           ----------          ---- 
cluster1            3.53.100.100        255.0.0.0           UNICAST

This example stops all cluster nodes on the local cluster.

Required Parameters

-InputObject

Specifies the cluster to stop.

Type:Cluster
Position:Named
Default value:None
Accept pipeline input:True (ByValue, ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-Drain

Drains existing traffic before stopping the cluster. If this parameter is omitted, then the existing traffic will be dropped.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-HostName

Specifies the name of the cluster host against which this cmdlet is run. If this parameter is omitted or a value of . is entered, then the local cluster is assumed.

Type:String
Aliases:hn
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InterfaceName

Specifies the interface to which NLB is bound. This is the interface of the cluster against which this cmdlet is run.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Timeout

Specifies the number of minutes to wait for the drain operation before stopping the cluster. After the time expires, the existing connections will be dropped.

Type:Nullable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.Cluster

Outputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.Cluster