This is the built-in help made by Microsoft for the command 'New-Cluster', in PowerShell version 5 - as retrieved from
Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Creates a new failover cluster.
New-Cluster [-Name] <String> [-AdministrativeAccessPoint {ActiveDirectoryAndDns | Dns | None}] [-Force] [-IgnoreNetwork <StringCollection>] [-Node <StringCollection>]
[-NoStorage] [-StaticAddress <StringCollection>] [<CommonParameters>]
The New-Cluster cmdlet creates a new failover cluster. Before creating a cluster, the hardware (servers, networks, and storage) must be connected, and the validation tests
must be run.
Use Test-Cluster to run the validation tests. The tests will confirm that the hardware and settings are compatible with failover clustering. There are multiple types of
tests, including Inventory, System Configuration, Network, Storage, and other types of tests.
Note: This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP) authentication on the server computer.
<
Online Version: http://go.microsoft.com/fwlink/?LinkId=321049
Add-ClusterNode
Get-Cluster
Remove-Cluster
Start-Cluster
Stop-Cluster
Test-Cluster
<
EXAMPLE 1
PS C:\>New-Cluster -Name cluster1 -Node node1,node2,node3,node4
Name
----
cluster1
This example creates a four-node cluster named cluster1, using default settings for IP addressing.
EXAMPLE 2
PS C:\>New-Cluster -Name cluster1 -Node node1,node2 -NoStorage
Name
----
cluster1
This example creates a two-node cluster named cluster1. The cluster will not have any clustered storage, or disk resources. Storage can be added using the
Get-ClusterAvailableDisk cmdlet with the Add-ClusterDisk cmdlet.
EXAMPLE 3
PS C:\>New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123
Name
----
cluster1
This example creates a four-node cluster named cluster1 that uses the static IP address 2.0.0.123.
EXAMPLE 4
PS C:\>New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123,3.0.0.123
Name
----
cluster1
This example creates a four-node cluster named cluster1 that uses the static IP addresses 2.0.0.123 and 3.0.0.123.
EXAMPLE 5
PS C:\>New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -IgnoreNetwork 2.0.0.0/8
Name
----
cluster1
This example creates a four-node cluster named cluster1. The cluster uses default settings for IP addressing, and does not use the network 2.0.0.0/8.
EXAMPLE 6
PS C:\>New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123 -IgnoreNetwork 3.0.0.0/8
Name
----
cluster1
This example creates a four-node cluster named cluster1. The cluster uses the static IP address 2.0.0.123, and does not use the network 3.0.0.0/8.