Add-AzureHDInsightScriptAction

HDInsight スクリプト アクションを追加します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

Add-AzureHDInsightScriptAction
   -Config <AzureHDInsightConfig>
   -Name <String>
   -ClusterRoleCollection <ClusterNodeType[]>
   -Uri <Uri>
   [-Parameters <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

説明

このバージョンの Azure PowerShell HDInsight は非推奨です。 これらのコマンドレットは、2017 年 1 月 1 日までに削除されます。 新しいバージョンの Azure PowerShell HDInsight を使用してください。

新しい HDInsight を使用してクラスターを作成する方法については、「Azure PowerShell () を使用して HDInsight で Linux ベースのクラスターを作成する」https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/を参照してください。 Azure PowerShell やその他の方法を使用してジョブを送信する方法については、HDInsight での Hadoop ジョブの送信 (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/) に関するページを参照してください。 Azure PowerShell HDInsight のリファレンス情報については、「Azure HDInsight コマンドレット」を参照してください

Add-AzureHDInsightScriptAction コマンドレットは、追加のソフトウェアをインストールしたり、Windows PowerShell スクリプトを使用して Hadoop クラスターで実行されるアプリケーションの構成を変更したりするために使用される Azure HDInsight 機能を提供します。

HDInsight クラスターがデプロイされると、クラスター ノードでスクリプト アクションが実行され、クラスター内のノードが HDInsight 構成を完了した後に実行されます。 スクリプト アクションは、システム管理者アカウントの特権で実行され、クラスター ノードへのフル アクセス権を提供します。 各クラスターには、指定したシーケンスで実行するスクリプト アクションの一覧を指定できます。

例 1: クラスターにスクリプト アクションを追加する

PS C:\>$Config = New-AzureHDInsightClusterConfig -ClusterSizeInNodes 4
PS C:\> $Config = Add-AzureHDInsightScriptAction -Config $Config -Name "TestScriptAction" -Uri http://test.com/test.ps1 -Parameters "test" -ClusterRoleCollection HeadNode,DataNode
PS C:\> New-AzureHDInsightCluster -Config $Config

最初のコマンドでは、 New-AzureHDInsightClusterConfig コマンドレットを使用して HDInsight クラスター構成を作成し、$Config変数に格納します。

2 番目のコマンドでは、 Add-AzureHDInsightScriptAction コマンドレットを使用して、TestScriptAction という名前のスクリプト アクションを$Configに追加します。

最後のコマンドでは、 New-AzureHDInsightCluster コマンドレットを使用して、$Configに格納されたスクリプト アクションを実行する新しい HDInsight クラスターを作成します。

例 2: クラスターに複数のスクリプト アクションを追加する

PS C:\>$Config = New-AzureHDInsightClusterConfig -ClusterSizeInNodes 4
PS C:\> $Config = Add-AzureHDInsightScriptAction -Config $Config -Name "TestScriptAction1" -Uri http://test.com/test1.ps1 -Parameters "Test1" -ClusterRoleCollection HeadNode,DataNode | Add-AzureHDInsightScriptAction -Config $Config -Name "TestScriptAction2" -Uri http://test.com/test2.ps1 -ClusterRoleCollection HeadNode
PS C:\> New-AzureHDInsightCluster -Config $Config

最初のコマンドでは、 New-AzureHDInsightClusterConfig コマンドレットを使用して HDInsight クラスター構成を作成し、$Config変数に格納します。

2 番目のコマンドでは、Add-AzureHDInsightScriptAction コマンドレットを使用して、指定したスクリプト アクションを$Configに追加し、パイプライン 演算子を使用して、$Configを Add-AzureHDInsightScriptAction に 2 回目に渡して、$Configに 2 つ目のスクリプト アクションを追加します。

最後のコマンドでは、 New-AzureHDInsightCluster コマンドレットを使用して、$Configでスクリプト アクションを実行するクラスターを作成します。

パラメーター

-ClusterRoleCollection

スクリプトを実行するノードを指定します。 このパラメーターに使用できる値は、HeadNode または DataNode です。

1 つまたは両方の値を指定できます。

型:ClusterNodeType[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Config

構成オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するオブジェクトにスクリプト アクション情報を追加します。

型:AzureHDInsightConfig
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

スクリプト アクションの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Parameters

スクリプト アクションに必要なパラメーターを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Uri

実行するスクリプトの URI の場所を指定します。

型:Uri
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False