New-Cluster
New-Cluster
Creates a new failover cluster.
Syntaxe
Parameter Set: Default
New-Cluster [-Name] <String> [-AdministrativeAccessPoint <AdminAccessPoint> {None | ActiveDirectoryAndDns | Dns | ActiveDirectory} ] [-Force] [-IgnoreNetwork <StringCollection> ] [-Node <StringCollection> ] [-NoStorage] [-StaticAddress <StringCollection> ] [ <CommonParameters>]
Description détaillée
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.
Paramètres
-AdministrativeAccessPoint<AdminAccessPoint>
Specifies the type of administrative access point that the cmdlet creates for the cluster. Les valeurs acceptables pour ce paramètre sont les suivantes :
-- ActiveDirectoryAndDns. The cmdlet creates an administrative access point for the cluster. The administrative access point is registered in DNS and enabled in Services de domaine Active Directory.
-- Dns. The cmdlet creates an administrative access point for the cluster. The administrative access point is registered in DNS but is not enabled in Services de domaine Active Directory.
-- None. The cmdlet does not create an administrative access point for the cluster. Some clustered roles and functionality might not be available for a cluster that does not have an administrative access point. Also, you cannot use Failover Cluster Manager to manage a cluster that does not have an administrative access point.
Alias |
aap |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Force
Force l'exécution de la commande sans demander une confirmation de l'utilisateur.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-IgnoreNetwork<StringCollection>
Specifies one or more networks to ignore when running the cmdlet. Networks with DHCP enabled are always included, but other networks need a static address to be specified using the StaticAddress parameter or should be explicitly ignored with this IgnoreNetwork parameter.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Name<String>
Specifies the name of the cluster to create.
Alias |
none |
Requis ? |
true |
Position ? |
1 |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-NoStorage
Specifies that shared storage is ignored during the cluster creation. The cluster created at the end of the operation will not have shared storage. Shared storage can later be added by piping the ClusterDiskInfo object from the Get-ClusterAvailableDisk cmdlet into the Add-ClusterDisk cmdlet.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Node<StringCollection>
Specifies a comma-separated list of cluster node names, or server names, on which to create the cluster. If this parameter is not specified, then a one node cluster is created on the local physical computer.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-StaticAddress<StringCollection>
Specifies one or more static addresses to use when running the cmdlet. Networks with DHCP enabled are always included, but other networks need a static address to be specified using the StaticAddress parameter or should be explicitly ignored with this IgnoreNetwork parameter.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.
- None
Sorties
Le type de sortie correspond au type des objets que l'applet de commande émet.
- Microsoft.FailoverClusters.PowerShell.Cluster
Exemples
EXAMPLE 1
This example creates a four-node cluster named cluster1, using default settings for IP addressing.
PS C:\> New-Cluster -Name cluster1 -Node node1,node2,node3,node4
EXAMPLE 2
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.
PS C:\> New-Cluster -Name cluster1 -Node node1,node2 -NoStorage
EXAMPLE 3
This example creates a four-node cluster named cluster1 that uses the static IP address 2.0.0.123.
PS C:\> New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123
EXAMPLE 4
This example creates a four-node cluster named cluster1 that uses the static IP addresses 2.0.0.123 and 3.0.0.123.
PS C:\> New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123,3.0.0.123
EXAMPLE 5
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.
PS C:\> New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -IgnoreNetwork 2.0.0.0/8
EXAMPLE 6
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.
PS C:\> New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123 -IgnoreNetwork 3.0.0.0/8