New-AzureHDInsightCluster

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

New-AzureHDInsightCluster

Creates a new Azure HDInsight cluster for the current subscription.

Syntax

Parameter Set: Cluster By Config (with Specific Subscription Credential)
New-AzureHDInsightCluster [-Name] <String> [-Config] <AzureHDInsightConfig> [[-Subscription] <String> ] [[-Certificate] <X509Certificate2> ] [-Location] <String> [-Credential] <PSCredential> [[-EndPoint] <Uri> ] [[-HostedService] <String> ] [[-Version] <String> ] [ <CommonParameters>]

Parameter Set: Cluster By Name (with Specific Subscription Credential)
New-AzureHDInsightCluster [-Name] <String> [[-Subscription] <String> ] [[-Certificate] <X509Certificate2> ] [-Location] <String> [-DefaultStorageAccountName] <String> [-DefaultStorageAccountKey] <String> [-DefaultStorageContainerName] <String> [-Credential] <PSCredential> [-ClusterSizeInNodes] <Int32> [[-EndPoint] <Uri> ] [[-HostedService] <String> ] [[-Version] <String> ] [[-HeadNodeVMSize] <NodeVMSize> ] [ <CommonParameters>]

Detailed Description

Creates a new Azure HDInsight cluster using the specified parameters or configuration created using the New-AzureHDInsightClusterConfig cmdlet.

This topic describes the cmdlet in the 0.8.1 version of the Microsoft Azure PowerShell module. To find out the version of the module you're using, from the Azure PowerShell console, type (get-module azure).version.

Parameters

-Certificate<X509Certificate2>

Management certificate of the Azure subscription.

Aliases	Cert
Required?	false
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ClusterSizeInNodes<Int32>

The number of data nodes to be created for the cluster.

Aliases	Nodes,Size
Required?	true
Position?	10
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Config<AzureHDInsightConfig>

A configuration object created using the New-AzureHDInsightClusterConfig cmdlet.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	True (ByValue)
Accept Wildcard Characters?	false

-Credential<PSCredential>

The user credentials for the Azure HDInsight cluster to be started.

Aliases	Cred
Required?	true
Position?	6
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DefaultStorageAccountKey<String>

The account key for the default storage account used by the HDInsight cluster.

Aliases	StorageKey
Required?	true
Position?	6
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DefaultStorageAccountName<String>

The name of the default storage account used by the HDInsight cluster.

Aliases	StorageAccount
Required?	true
Position?	5
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DefaultStorageContainerName<String>

The name of the default container in the default Azure Storage Account used by the HDInsight cluster.

Aliases	StorageContainer
Required?	true
Position?	7
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-EndPoint<Uri>

Specifies the endpoint to use when connecting to Azure if the endpoint is different from the default.

Aliases	none
Required?	false
Position?	8
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-HeadNodeVMSize<NodeVMSize>

Specifies the size of the VM for the head node.

Aliases	none
Required?	false
Position?	14
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-HostedService<String>

The namespace of the Azure HDInsight Service if it is different from the default.

Aliases	CloudServiceName
Required?	false
Position?	12
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Location<String>

The region that the HDInsight cluster will be created in.

Aliases	Loc
Required?	true
Position?	5
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Name<String>

The name of the Azure HDInsight cluster.

Aliases	ClusterName,DnsName
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Subscription<String>

The Azure subscription in which the new HDInsight cluster is being created.

Aliases	Sub
Required?	false
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Version<String>

The HDInsight cluster version to be created.

Aliases	Ver
Required?	false
Position?	13
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Create HDInsight cluster

Create a new Azure HDInsight cluster for the current subscription.

PS C:\> $subid = (Get-AzureSubscription –Current).SubscriptionId$key1 = Get-AzureStorageKey yourblobstorage | %{ $_.Primary }$key2 = Get-AzureStorageKey yoursecondblobstorage | %{ $_.Primary }$creds = Get-Credential$oozieCreds = Get-Credential$hiveCreds = Get-Credential        New-AzureHDInsightClusterConfig -ClusterSizeInNodes 4 |        Set-AzureHDInsightDefaultStorage -StorageAccountName yourblobstorage.blob.core.windows.net        -StorageAccountKey $key1 -StorageContainerName "yourcontainer" |        Add-AzureHDInsightStorage -StorageAccountName yoursecondbobstorage.blob.core.windows.net        -StorageAccountKey $key2 |        Add-AzureHDInsightMetastore -SqlAzureServerName "yoursqlserver.database.windows.net"        -DatabaseName "yourOozieDatabaseName" -Credential $oozieCreds -MetastoreType OozieMetastore |        Add-AzureHDInsightMetastore -SqlAzureServerName "yoursqlserver.database.windows.net"        -DatabaseName "yourHiveDatabaseName" -Credential $hiveCreds -MetastoreType HiveMetastore |        New-AzureHDInsightCluster -Credential $creds