New-WorkgroupCluster
Creates a new workgroup cluster.
Syntax
New-WorkgroupCluster
[[-Node] <String[]>]
[[-Credentials] <PSCredential[]>]
[[-Name] <String>]
[[-StaticAddress] <String[]>]
[[-IgnoreNetwork] <String[]>]
[[-ManagementPointNetworkType] <AdminAccessPointResType>]
[[-AdministrativeAccessPoint] <AdminAccessPoint>]
[-NoStorage]
[-S2D]
[-Force]
[-Confirm]
[-WhatIf]
[<CommonParameters>] Description
The New-WorkgroupCluster cmdlet creates a new workgroup cluster.
Examples
EXAMPLE 1
New-WorkgroupCluster -Node "Node1", "Node2" -Credentials $cred1, $cred2 -Name "Cluster1"This example creates a new workgroup cluster named Cluster1 with Node1 and Node2 using
the credentials in $cred1 and $cred2.
Note: Only None and DNS are supported for AdministrativeAccessPoint.
Parameters
-AdministrativeAccessPoint
Specifies the type of administrative access point that the cmdlet creates for the cluster. Acceptable values are:
DNS: The cmdlet creates an administrative access point for the cluster. The administrative access point is registered in DNS but isn't enabled in Active Directory Domain Services.None
The cmdlet doesn't create an administrative access point for the cluster. Some clustered roles and functionality might not be available for a cluster that doesn't have an administrative access point. Also, you cannot use Failover Cluster Manager to manage a cluster that doesn't have an administrative access point.
| Type: | AdminAccessPoint |
| Accepted values: | None, Dns |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credentials
An array of credentials for the nodes.
| Type: | PSCredential[] |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Forces the command to run without asking for user confirmation.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IgnoreNetwork
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.
| Type: | String[] |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementPointNetworkType
Specifies the network configuration used to determine IP address settings. Acceptable values are:
Automatic: Automatically detects the appropriate setting.- If SQL Server is running in Azure, it uses
Distributed. - If SQL Server is running on-premises, it uses
Singleton.
- If SQL Server is running in Azure, it uses
Singleton: The traditional method of DHCP or static IP address.Distributed: Uses a Distributed Network Name by using Node IP addresses.
For on-prem SQL Server, if the value is set to Automatic, it defaults to Singleton.
| Type: | AdminAccessPointResType |
| Accepted values: | Automatic, Singleton, Distributed |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
The name of the workgroup cluster.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Node
An array of nodes to be included in the cluster.
| Type: | String[] |
| Position: | 1 |
| Default value: | @() |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoStorage
Specifies that shared storage is ignored for the workgroup cluster node.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-S2D
Specifies whether to enable Storage Spaces Direct when creating the workgroup cluster.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StaticAddress
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.
| Type: | String[] |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet isn't run.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |