New-ClusterNameAccount

  • Reference
Module:
FailoverClusters

Creates a cluster name account in Active Directory Domain Services.

Syntax

New-ClusterNameAccount
   -Name <String>
   [-Credentials <PSCredential>]
   [-Domain <String>]
   [-InputObject <PSObject>]
   [-Cluster <String>]
   [<CommonParameters>]
New-ClusterNameAccount
   -Name <String>
   -Credentials <PSCredential>
   -Domain <String>
   [-Cluster <String>]
   [<CommonParameters>]

Description

The New-ClusterNameAccount cmdlet creates a cluster name account in Active Directory Domain Services. A cluster name account is also referred to as a cluster name object (CNO). This cmdlet changes the existing cluster name to match the cluster name account that it creates. If a cluster name account already exists for a cluster, this cmdlet has no effect.

Examples

Example 1: Create a cluster name account for the current cluster

PS C:\> New-ClusterNameAccount -Name "cluster_17" -Domain "production.contoso.com"

This command creates a cluster name account for the current cluster in the specified domain. The current cluster is the default value for the cluster on which this cmdlet operates.

Example 2: Create a cluster name account by using credentials

PS C:\> $Credential = Get-Credential
PS C:\> New-ClusterNameAccount -Name "cluster27" -Domain "production.contoso.com" -Credentials $Credential

The first command prompts you for credentials, and then stores them in the $Credential variable.

The second command creates a cluster name account for the current cluster in the specified domain. The command supplies the credentials stored in $Credential to access Active Directory Domain Services.

Parameters

-Cluster

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credentials

Specifies the credentials that this cmdlet uses when it connects to Active Directory Domain Services. To obtain credentials, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Domain

Specifies the Active Directory Domain Services domain in which this cmdlet creates a cluster name account.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the cluster for which this cmdlet adds a cluster name account.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies the name of the cluster name account that this cmdlet creates.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

This cmdlet accepts a Cluster object for which it creates a cluster name account.