Delen via

Add-AzureHDInsightScriptAction

  • Referentie
Module:
Azure

Hiermee voegt u een HDInsight-scriptactie toe.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

Deze versie van Azure PowerShell HDInsight is afgeschaft. Deze cmdlets worden verwijderd op 1 januari 2017. Gebruik de nieuwere versie van Azure PowerShell HDInsight.

Zie Op Linux gebaseerde clusters maken in HDInsight met behulp van Azure PowerShell (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/) voor informatie over het gebruik van de nieuwe HDInsight om een cluster te maken. Zie Hadoop-taken verzenden in HDInsight (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/) voor meer informatie over het verzenden van taken met behulp van Azure PowerShell en andere benaderingen. Zie Azure HDInsight-cmdlets voor naslaginformatie over Azure PowerShell HDInsight.

De cmdlet Add-AzureHDInsightScriptAction biedt Azure HDInsight-functionaliteit die wordt gebruikt om extra software te installeren of om de configuratie te wijzigen van toepassingen die worden uitgevoerd op een Hadoop-cluster met behulp van Windows PowerShell-scripts.

Een scriptactie wordt uitgevoerd op de clusterknooppunten wanneer HDInsight-clusters worden geïmplementeerd en worden uitgevoerd nadat knooppunten in het cluster de HDInsight-configuratie hebben voltooid. De scriptactie wordt uitgevoerd onder bevoegdheden van het systeembeheerdersaccount en biedt volledige toegangsrechten voor de clusterknooppunten. U kunt elk cluster voorzien van een lijst met scriptacties die in een opgegeven volgorde moeten worden uitgevoerd.

Voorbeelden

Voorbeeld 1: Een scriptactie toevoegen aan een 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

De eerste opdracht maakt gebruik van de cmdlet New-AzureHDInsightClusterConfig om een HDInsight-clusterconfiguratie te maken en slaat deze vervolgens op in de $Config variabele.

De tweede opdracht maakt gebruik van de cmdlet Add-AzureHDInsightScriptAction om de scriptactie TestScriptAction toe te voegen aan $Config.

De laatste opdracht maakt gebruik van de cmdlet New-AzureHDInsightCluster om een nieuw HDInsight-cluster te maken waarmee de scriptactie wordt uitgevoerd die is opgeslagen in $Config.

Voorbeeld 2: Meerdere scriptacties toevoegen aan een 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

De eerste opdracht maakt gebruik van de cmdlet New-AzureHDInsightClusterConfig om een HDInsight-clusterconfiguratie te maken en slaat deze vervolgens op in de $Config variabele.

De tweede opdracht maakt gebruik van de cmdlet Add-AzureHDInsightScriptAction om de opgegeven scriptactie toe te voegen aan $Config en gebruikt vervolgens de pijplijnoperator om $Config door te geven aan Add-AzureHDInsightScriptAction een tweede keer om een tweede scriptactie toe te voegen aan $Config.

De laatste opdracht maakt gebruik van de cmdlet New-AzureHDInsightCluster om een cluster te maken waarmee de scriptacties in $Config worden uitgevoerd.

Parameters

-ClusterRoleCollection

Hiermee geeft u de knooppunten op waarvoor een script moet worden uitgevoerd. De acceptabele waarden voor deze parameter zijn: HeadNode of DataNode.

U kunt één waarde of beide waarden opgeven.

Type:ClusterNodeType[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Config

Hiermee geeft u een configuratieobject. Met deze cmdlet voegt u scriptactiegegevens toe aan het object dat met deze parameter wordt opgegeven.

Type:AzureHDInsightConfig
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een scriptactie.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Parameters

Hiermee geeft u de parameters op die vereist zijn voor een scriptactie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Uri

Hiermee geeft u de URI-locatie van een script dat moet worden uitgevoerd.

Type:Uri
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False