Add-AzureHDInsightScriptAction

Fügt eine HDInsight-Skriptaktion hinzu.

Hinweis

Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Diese Version von Azure PowerShell HDInsight ist veraltet. Diese Cmdlets werden bis zum 1. Januar 2017 entfernt. Verwenden Sie die neuere Version von Azure PowerShell HDInsight.

Informationen zur Verwendung des neuen HDInsight zum Erstellen eines Clusters finden Sie unter Erstellen linuxbasierter Cluster in HDInsight mithilfe von Azure PowerShell (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/). Informationen zum Übermitteln von Aufträgen mithilfe von Azure PowerShell und anderen Ansätzen finden Sie unter Submit Hadoop jobs in HDInsight (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/). Referenzinformationen zu Azure PowerShell HDInsight finden Sie unter Azure HDInsight-Cmdlets.

Das Add-AzureHDInsightScriptAction-Cmdlet stellt Azure HDInsight-Funktionen bereit, die zum Installieren zusätzlicher Software oder zum Ändern der Konfiguration von Anwendungen verwendet werden, die auf einem Hadoop-Cluster mithilfe von Windows PowerShell-Skripts ausgeführt werden.

Eine Skriptaktion wird auf den Clusterknoten ausgeführt, wenn HDInsight-Cluster bereitgestellt werden, und sie werden nach Knoten im Cluster vollständigen HDInsight-Konfiguration ausgeführt. Die Skriptaktion wird unter Systemadministratorkontoberechtigungen ausgeführt und bietet Vollzugriffsrechte für die Clusterknoten. Sie können jedem Cluster eine Liste von Skriptaktionen bereitstellen, die in einer angegebenen Sequenz ausgeführt werden sollen.

Beispiele

Beispiel 1: Hinzufügen einer Skriptaktion zu einem Cluster

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

Der erste Befehl verwendet das Cmdlet New-AzureHDInsightClusterConfig zum Erstellen einer HDInsight-Clusterkonfiguration und speichert ihn dann in der $Config Variablen.

Der zweite Befehl verwendet das Add-AzureHDInsightScriptAction-Cmdlet , um die Skriptaktion mit dem Namen TestScriptAction zu $Config hinzuzufügen.

Der letzte Befehl verwendet das Cmdlet New-AzureHDInsightCluster , um einen neuen HDInsight-Cluster zu erstellen, der die in $Config gespeicherte Skriptaktion ausführt.

Beispiel 2: Hinzufügen mehrerer Skriptaktionen zu einem Cluster

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

Der erste Befehl verwendet das Cmdlet New-AzureHDInsightClusterConfig zum Erstellen einer HDInsight-Clusterkonfiguration und speichert ihn dann in der $Config Variablen.

Der zweite Befehl verwendet das Add-AzureHDInsightScriptAction-Cmdlet , um die angegebene Skriptaktion zu $Config hinzuzufügen, und verwendet dann den Pipelineoperator, um $Config an Add-AzureHDInsightScriptAction ein zweites Mal zu übergeben, um $Config eine zweite Skriptaktion hinzuzufügen.

Der letzte Befehl verwendet das Cmdlet New-AzureHDInsightCluster , um einen Cluster zu erstellen, der die Skriptaktionen in $Config ausführt.

Parameter

-ClusterRoleCollection

Gibt die Knoten an, für die ein Skript ausgeführt werden soll. Die zulässigen Werte für diesen Parameter sind: HeadNode oder DataNode.

Sie können einen Wert oder beide Werte angeben.

Typ:ClusterNodeType[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Config

Gibt ein Konfigurationsobjekt an. Dieses Cmdlet fügt dem Objekt, das dieser Parameter angibt, Skriptaktionsinformationen hinzu.

Typ:AzureHDInsightConfig
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen einer Skriptaktion an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Parameters

Gibt die Parameter an, die für eine Skriptaktion erforderlich sind.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Uri

Gibt den URI-Speicherort eines auszuführenden Skripts an.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False