Add-AzureRmHDInsightScriptAction
クラスター構成オブジェクトにスクリプト アクションを追加します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Add-AzureRmHDInsightScriptAction
[-Config] <AzureHDInsightConfig>
[-NodeType] <ClusterNodeType>
[-Uri] <Uri>
[-Name] <String>
[[-Parameters] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
Add-AzureRmHDInsightScriptAction コマンドレットは、New-AzureRmHDInsightClusterConfig コマンドレットによって作成された HDInsight 構成オブジェクトにスクリプト アクションを追加します。 スクリプト アクションは、Windows PowerShell または Bash スクリプト (Windows または Linux クラスターの場合) を使用して、追加のソフトウェアをインストールしたり、Hadoop クラスターで実行するアプリケーションの構成を変更したりするために使用される機能を提供します。 HDInsight クラスターがデプロイされると、クラスター ノードでスクリプト アクションが実行され、クラスター内のノードが HDInsight 構成を完了した後に実行されます。 スクリプト アクションは、システム管理者アカウントの特権で実行され、クラスター ノードへのフル アクセス権を提供します。 各クラスターには、指定したシーケンスで実行するスクリプト アクションの一覧を指定できます。
例
例 1: クラスター構成オブジェクトにスクリプト アクションを追加する
PS C:\># Primary storage account info
PS C:\> $storageAccountResourceGroupName = "Group"
PS C:\> $storageAccountName = "yourstorageacct001"
PS C:\> $storageAccountKey = (Get-AzureRmStorageAccountKey -ResourceGroupName $storageAccountResourceGroupName -Name $storageAccountName)[0].value
PS C:\> $storageContainer = "container001"
# Script action info
PS C:\> $scriptActionName = "<script action name>"
PS C:\> $scriptActionURI = "<script action URI>"
PS C:\> $scriptActionParameters = "<script action parameters>"
# Cluster configuration info
PS C:\> $location = "East US 2"
PS C:\> $clusterResourceGroupName = "Group"
PS C:\> $clusterName = "your-hadoop-001"
PS C:\> $clusterCreds = Get-Credential
# If the cluster's resource group doesn't exist yet, run:
# New-AzureRmResourceGroup -Name $clusterResourceGroupName -Location $location
# Create the cluster
PS C:\> New-AzureRmHDInsightClusterConfig `
| Add-AzureRmHDInsightScriptAction `
-Name $scriptActionName `
-Uri $scriptActionURI `
-Parameters $scriptActionParameters `
-NodeType Worker `
| Add-AzureRmHDInsightScriptAction `
-Name $scriptActionName `
-Uri $scriptActionURI `
-Parameters $scriptActionParameters `
-NodeType Head `
| New-AzureRmHDInsightCluster `
-ClusterType Hadoop `
-OSType Windows `
-ClusterSizeInNodes 4 `
-ResourceGroupName $clusterResourceGroupName `
-ClusterName $clusterName `
-HttpCredential $clusterCreds `
-Location $location `
-DefaultStorageAccountName "$storageAccountName.blob.core.contoso.net" `
-DefaultStorageAccountKey $storageAccountKey `
-DefaultStorageContainer $storageContainerこのコマンドは、クラスターの作成時に実行される、hadoop-001 クラスターのヘッド ノードとワーカー ノードのスクリプト アクションを追加します。
パラメーター
-Config
このコマンドレットが変更する HDInsight クラスター構成オブジェクトを指定します。 このオブジェクトは、 New-AzureRmHDInsightClusterConfig コマンドレットによって作成されます。
| 型: | AzureHDInsightConfig |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
| 型: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
スクリプト アクションの名前を指定します。
| 型: | String |
| 配置: | 3 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NodeType
スクリプト アクションを実行するノードの種類を指定します。 このパラメーターの有効値は、次のとおりです。
- HeadNode
- WorkerNode
- ZookeeperNode
| 型: | ClusterNodeType |
| 指定可能な値: | HeadNode, WorkerNode, ZookeeperNode, EdgeNode |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Parameters
スクリプト アクションのパラメーターを指定します。
| 型: | String |
| 配置: | 4 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Uri
スクリプト アクション (PowerShell または Bash スクリプト) のパブリック URI を指定します。
| 型: | Uri |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
パラメーター: Config (ByValue)