Edit

Share via

Stop-NlbCluster

  • Reference
Module:
NetworkLoadBalancingClusters

Stops all nodes of a NLB cluster.

Syntax

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

Description

The Stop-NlbCluster cmdlet stops all nodes in a Network Load Balancing (NLB) cluster. The cmdlet stops 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: Stop all cluster nodes on the local cluster

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.

Parameters

-Drain

Indicates that the cmdlet drains existing traffic before stopping the cluster. If this parameter is omitted, then the existing traffic is dropped.

Type:SwitchParameter
Aliases:D
Position:Named
Default value:None
Required:False
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:Host, HN, H
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the cluster to stop.

Type:Cluster[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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
Aliases:Interface, IN, I
Position:1
Default value:None
Required:False
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 are dropped.

Type:UInt32
Aliases:T
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.Cluster

Outputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.Cluster