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 (http://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