Compartilhar via

Add-AzureHDInsightScriptAction

  • Referência
Módulo:
Azure

Adiciona uma ação de script HDInsight.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

Description

Esta versão do Azure PowerShell HDInsight foi preterida. Esses cmdlets serão removidos até 1º de janeiro de 2017. Use a versão mais recente do Azure PowerShell HDInsight.

Para obter informações sobre como usar o novo HDInsight para criar um cluster, consulte Criar clusters baseados em Linux no HDInsight usando o Azure PowerShell (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/). Para obter informações sobre como enviar trabalhos usando o Azure PowerShell e outras abordagens, consulte Enviar trabalhos do Hadoop no HDInsight (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/). Para obter informações de referência sobre o Azure PowerShell HDInsight, consulte Cmdlets do Azure HDInsight.

O cmdlet Add-AzureHDInsightScriptAction fornece a funcionalidade do Azure HDInsight que é usada para instalar software adicional ou alterar a configuração de aplicativos executados em um cluster do Hadoop usando scripts do Windows PowerShell.

Uma ação de script é executada nos nós do cluster quando os clusters do HDInsight são implantados e eles são executados depois que os nós no cluster concluem a configuração do HDInsight. A ação de script é executada sob privilégios de conta de administrador do sistema e fornece direitos de acesso total aos nós do cluster. Você pode fornecer a cada cluster uma lista de ações de script a serem executadas em uma sequência especificada.

Exemplos

Exemplo 1: Adicionar uma ação de script a um 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

O primeiro comando usa o cmdlet New-AzureHDInsightClusterConfig para criar uma configuração de cluster HDInsight e, em seguida, armazena-a na variável $Config.

O segundo comando usa o cmdlet Add-AzureHDInsightScriptAction para adicionar a ação de script chamada TestScriptAction a $Config.

O comando final usa o cmdlet New-AzureHDInsightCluster para criar um novo cluster HDInsight que executa a ação de script armazenada no $Config.

Exemplo 2: Adicionar várias ações de script a um 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

O primeiro comando usa o cmdlet New-AzureHDInsightClusterConfig para criar uma configuração de cluster HDInsight e, em seguida, armazena-a na variável $Config.

O segundo comando usa o cmdlet Add-AzureHDInsightScriptAction para adicionar a ação de script especificada a $Config e, em seguida, usa o operador de pipeline para passar $Config para Add-AzureHDInsightScriptAction uma segunda vez para adicionar uma segunda ação de script a $Config.

O comando final usa o cmdlet New-AzureHDInsightCluster para criar um cluster que executa as ações de script em $Config.

Parâmetros

-ClusterRoleCollection

Especifica os nós para os quais executar um script. Os valores aceitáveis para esse parâmetro são: HeadNode ou DataNode.

Você pode especificar um valor ou ambos os valores.

Tipo:ClusterNodeType[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Config

Especifica um objeto de configuração. Esse cmdlet adiciona informações de ação de script ao objeto especificado por esse parâmetro.

Tipo:AzureHDInsightConfig
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome de uma ação de script.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Parameters

Especifica os parâmetros exigidos por uma ação de script.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Uri

Especifica o local do URI de um script a ser executado.

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False