Share via


Add-AzureHDInsightScriptAction

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

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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 つまたは両方の値を指定できます。

Type:ClusterNodeType[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Config

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

Type:AzureHDInsightConfig
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Parameters

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Uri

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

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False