Add-AzureHDInsightScriptAction

Fügt eine HDInsight-Skriptaktion hinzu.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

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

-Config

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

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

-Name

Gibt den Namen einer Skriptaktion an.

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

-Parameters

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

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

-Profile

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

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

-Uri

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

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