Add-AzHDInsightScriptAction
クラスター構成オブジェクトにスクリプト アクションを追加します。
構文
Default (既定)
Add-AzHDInsightScriptAction
[-Config] <AzureHDInsightConfig>
[-NodeType] <ClusterNodeType>
[-Uri] <Uri>
[-Name] <String>
[[-Parameters] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzHDInsightScriptAction コマンドレットは、New-AzHDInsightClusterConfig コマンドレットによって作成された HDInsight 構成オブジェクトにスクリプト アクションを追加します。
スクリプト アクションは、追加のソフトウェアをインストールしたり、Windows PowerShell または Bash スクリプト (それぞれ Windows または Linux クラスター) を使用して Hadoop クラスターで実行されるアプリケーションの構成を変更したりするために使用される機能を提供します。
HDInsight クラスターがデプロイされると、クラスター ノードでスクリプト アクションが実行され、クラスター内のノードが HDInsight 構成を完了した後に実行されます。
スクリプト アクションは、システム管理者アカウントの特権で実行され、クラスター ノードへのフル アクセス権を提供します。
各クラスターには、指定したシーケンスで実行するスクリプト アクションの一覧を指定できます。
例
例 1: クラスター構成オブジェクトにスクリプト アクションを追加する
# Primary storage account info
$storageAccountResourceGroupName = "Group"
$storageAccountResourceId = "yourstorageaccountresourceid"
$storageAccountName = "yourstorageacct001"
$storageAccountKey = (Get-AzStorageAccountKey -ResourceGroupName $storageAccountResourceGroupName -Name $storageAccountName)[0].value
$storageContainer = "container001"
# Script action info
$scriptActionName = "<script action name>"
$scriptActionURI = "<script action URI>"
$scriptActionParameters = "<script action parameters>"
# Cluster configuration info
$location = "East US 2"
$clusterResourceGroupName = "Group"
$clusterName = "your-hadoop-001"
$clusterCreds = Get-Credential
# If the cluster's resource group doesn't exist yet, run:
# New-AzResourceGroup -Name $clusterResourceGroupName -Location $location
# Create the cluster
New-AzHDInsightClusterConfig `
| Add-AzHDInsightScriptAction `
-Name $scriptActionName `
-Uri $scriptActionURI `
-Parameters $scriptActionParameters `
-NodeType Worker `
| Add-AzHDInsightScriptAction `
-Name $scriptActionName `
-Uri $scriptActionURI `
-Parameters $scriptActionParameters `
-NodeType Head `
| New-AzHDInsightCluster `
-ClusterType Hadoop `
-OSType Windows `
-ClusterSizeInNodes 4 `
-ResourceGroupName $clusterResourceGroupName `
-ClusterName $clusterName `
-HttpCredential $clusterCreds `
-Location $location `
-StorageAccountResourceId $storageAccountResourceId `
-StorageAccountKey $storageAccountKey `
-StorageContainer $storageContainer
このコマンドは、クラスターの作成時に実行される、hadoop-001 クラスターのヘッド ノードとワーカー ノードのスクリプト アクションを追加します。
パラメーター
-Config
このコマンドレットが変更する HDInsight クラスター構成オブジェクトを指定します。
このオブジェクトは、 New-AzHDInsightClusterConfig コマンドレットによって作成されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
スクリプト アクションの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NodeType
スクリプト アクションを実行するノードの種類を指定します。
このパラメーターに使用できる値は次のとおりです。
- HeadNode
- WorkerNode
- ZookeeperNode
パラメーターのプロパティ
| 型: | ClusterNodeType
|
| 規定値: | None |
| 指定可能な値: | HeadNode, WorkerNode, ZookeeperNode, EdgeNode |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Parameters
スクリプト アクションのパラメーターを指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Uri
スクリプト アクション (PowerShell または Bash スクリプト) のパブリック URI を指定します。
パラメーターのプロパティ
| 型: | Uri
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力