New-ClusterNameAccount
New-ClusterNameAccount
Creates a cluster name account in Active Directory-Domänendienste.
Syntax
Parameter Set: Credentials
New-ClusterNameAccount -Credentials <PSCredential> -Domain <String> -Name <String> [-Cluster <String> ] [ <CommonParameters>]
Parameter Set: InputObject
New-ClusterNameAccount -Name <String> [-Cluster <String> ] [-Credentials <PSCredential> ] [-Domain <String> ] [-InputObject <PSObject> ] [ <CommonParameters>]
Detaillierte Beschreibung
The New-ClusterNameAccount cmdlet creates a cluster name account in Active Directory-Domänendienste. 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.
Parameter
-Cluster<String>
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.
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Credentials<PSCredential>
Specifies the credentials that this cmdlet uses when it connects to Active Directory-Domänendienste. To obtain credentials, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential
.
Aliase |
none |
Erforderlich? |
true |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Domain<String>
Specifies the Active Directory-Domänendienste domain in which this cmdlet creates a cluster name account.
Aliase |
none |
Erforderlich? |
true |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-InputObject<PSObject>
Specifies the cluster for which this cmdlet adds a cluster name account.
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
true(ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-Name<String>
Specifies the name of the cluster name account that this cmdlet creates.
Aliase |
none |
Erforderlich? |
true |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.
Microsoft.FailoverClusters.PowerShell.Cluster
This cmdlet accepts a Cluster object for which it creates a cluster name account.
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
Beispiele
Example 1: Create a cluster name account for the current cluster
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.
PS C:\> New-ClusterNameAccount -Name "cluster_17" -Domain "production.contoso.com"
Example 2: Create a cluster name account by using credentials
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-Domänendienste.
PS C:\> $Credential = Get-Credential
PS C:\> New-ClusterNameAccount -Name "cluster27" -Domain "production.contoso.com" -Credentials $Credential