Cluster

Applies To: Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2

Cluster contains the settings to specify details about a cluster, such as its interface, IP address, portrules, and so on.

Note

To enable this Network Load Balancing setting, the NetworkLoadBalancingFullServer package must be enabled in the Windows® image you are installing. To do this, use Windows System Image Manager to add the Microsoft-Windows-Foundation-Package to your answer file, and then configure the NetworkLoadBalancingFullServer package to enable it. For more information about adding and configuring packages, see the Windows® Assessment and Deployment (Windows ADK) Technical Reference.

Child Elements

BDATeam

Specifies details about a bidirectional affinity (BDA) team.

ClusterIpAddress

Specifies the cluster primary IP address.

ClusterIpToClusterMacEnabled

Specifies whether the cluster MAC address is automatically calculated from the primary cluster IP address.

ClusterMacAddress

Specifies the cluster MAC address to be used when configuring a unicast cluster.

ClusterMode

Specifies the mode for the cluster.

ClusterName

Specifies a full Internet name for the cluster.

ClusterNetMask

Specifies the subnet mask for the cluster IP address.

DedicatedIpAddresses

Specifies the host's unique IP addresses.

HostIdentifier

Specifies the host identifier used by this cluster.

ICMPFilteringEnabled

Specifies whether Internet Control Message Protocol (ICMP) filtering is enabled for the cluster.

IdentityHeartbeatPeriod

Specifies the recurrence interval for transmitting identity heartbeats between the NetworkLoadBalancing cluster hosts.

InitialHostState

Specifies the initial host state for the cluster.

Interface

Specifies the interface name to bind to network load balancing (NLB). This is a required setting.

MaskSourceMacEnabled

Specifies whether source Media Access Control (MAC) address masking is used.

MaximumConnectionDescriptors

Specifies the maximum number of descriptors per allocation for the cluster.

MembershipHeartbeatLossTolerance

Specifies the number of lost heartbeat messages before Setup considers the Network Load Balancing cluster host inactive and initiates convergence.

MembershipHeartbeatPeriod

Specifies a period between sending Network Load Balancing cluster heartbeat messages.

MulticastSpoofEnabled

Specifies whether address resolution protocol (ARP) traffic should be spoofed.

NetBTSupportEnabled

Specifies whether NetBT support is enabled for the cluster.

PersistSuspendedState

Specifies whether a host that is shut down while in a suspended state will remain suspended when Windows® is started.

Portrules

Specifies details about the port rules that are used for the cluster, including a port rule's name, virtual IP address, protocol, mode, and so on.

UnicastInterHostCommunicationSupportEnabled

Specifies whether unicast, interhost communication support is enabled for the cluster.

VirtualIpAddresses

Specifies the cluster’s virtual IP addresses.

Valid Configuration Passes

specialize

Parent Hierarchy

Microsoft-Windows-NetworkLoadBalancing-Core | Clusters | Cluster

Applies To

For a list of the Windows editions and architectures that this component supports, see Microsoft-Windows-NetworkLoadBalancing-Core.

XML Example

The following XML output shows how to specify details about a cluster.

<Cluster>
   <Interface>Local Area Connection 2</Interface>
   <ClusterIpAddress>10.100.0.234</ClusterIpAddress>
   <ClusterNetMask>255.255.255.0</ClusterNetMask>
   <VirtualIpAddresses>
      <IpAddress wcm:keyValue="Ip1">
         <IpAddress>10.192.45.1</IpAddress>
         <NetworkMask>255.255.255.0</NetworkMask>
      </IpAddress>
      <IpAddress wcm:keyValue="Ip2">
         <IpAddress>fe80::204:23ff:feb9:1111</IpAddress>
      </IpAddress>
   </VirtualIpAddresses>
   <Portrules>
      <Portrule wcm:keyValue="Portrule1">
         <VirtualIpAddress>255.255.255.255</VirtualIpAddress>
         <Protocol>TCP</Protocol>
         <StartPort>0</StartPort>
         <EndPort>65535</EndPort>
         <Mode>MultipleHost</Mode>
         <EqualLoad>true</EqualLoad>
         <ClientAffinity>None</ClientAffinity>
      </Portrule>
      <Portrule wcm:keyValue="Portrule2">
         <VirtualIpAddress>10.100.0.223</VirtualIpAddress>
         <Protocol>Both</Protocol>
         <StartPort>80</StartPort>
         <EndPort>80</EndPort>
         <Mode>MultipleHost</Mode>
         <LoadWeight>100</LoadWeight>
         <ClientAffinity>Single</ClientAffinity>
      </Portrule>
      <Portrule wcm:keyValue="Portrule3">
         <VirtualIpAddress>10.100.0.99</VirtualIpAddress>
         <Protocol>TCP</Protocol>
         <StartPort>23</StartPort>
         <EndPort>23</EndPort>
         <Mode>Disabled</Mode>
      </Portrule>
      <Portrule wcm:keyValue="Portrule4">
         <VirtualIpAddress>255.255.255.255</VirtualIpAddress>
         <Protocol>UDP</Protocol>
         <StartPort>25</StartPort>
         <EndPort>25</EndPort>
         <Mode>MultipleHost</Mode>
         <EqualLoad>true</EqualLoad>
         <ClientAffinity>Network</ClientAffinity>
      </Portrule>
      <Portrule wcm:keyValue="Portrule5">
         <VirtualIpAddress>10.100.0.223</VirtualIpAddress>
         <Protocol>TCP</Protocol>
         <StartPort>3389</StartPort>
         <EndPort>3389</EndPort>
         <Mode>SingleHost</Mode>
         <HostPriority>1</HostPriority>
      </Portrule>
   </Portrules>
   <DedicatedIpAddresses>
      <IpAddress wcm:keyValue="Ip1">
         <IpAddress>10.192.45.1</IpAddress>
         <NetworkMask>255.255.255.0</NetworkMask>
      </IpAddress>
      <IpAddress wcm:keyValue="Ip2">
         <IpAddress>fe80::204:23ff:feb9:1111</IpAddress>
      </IpAddress>
   </DedicatedIpAddresses>
   <HostIdentifier>6</HostIdentifier>
   <ClusterMacAddress>02-bf-01-02-03-04</ClusterMacAddress>
   <ClusterName>mycluster.domain.com</ClusterName>
   <ClusterMode>Multicast</ClusterMode>
   <InitialHostState>Started</InitialHostState>
   <PersistSuspendedState>false</PersistSuspendedState>
   <MembershipHeartbeatPeriod>1000</MembershipHeartbeatPeriod>
   <MembershipHeartbeatLossTolerance>5</MembershipHeartbeatLossTolerance>
   <IdentityHeartbeatPeriod>2000</IdentityHeartbeatPeriod>
   <MulticastSpoofEnabled>false</MulticastSpoofEnabled>
   <MaskSourceMacEnabled>true</MaskSourceMacEnabled>
   <ICMPFilteringEnabled>false</ICMPFilteringEnabled>
   <NetBTSupportEnabled>true</NetBTSupportEnabled>
   <ClusterIpToClusterMacEnabled>true</ClusterIpToClusterMacEnabled>
   <UnicastInterHostCommunicationSupportEnabled>true</UnicastInterHostCommunicationSupportEnabled>
   <MaximumConnectionDescriptors>512</MaximumConnectionDescriptors>
   <BDATeam>
      <Team>{BF967924-0DE6-11D0-A285-00AA003049E2}</Team>
      <Master>true</Master>
      <ReverseHash>true</ReverseHash>
   </BDATeam>
</Cluster>

See Also

Concepts

Clusters