Modifica

Condividi tramite

New-WorkgroupCluster

  • Reference
Module:
FailoverClusters

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.
  • 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