Add-AzureHDInsightScriptAction

  • Referência
Módulo:
Azure

Adiciona uma ação de script do HDInsight.

Nota

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

O módulo Az PowerShell é o módulo PowerShell recomendado 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 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 Hadoop usando scripts do Windows PowerShell.

Uma ação de script é executada nos nós do cluster quando os clusters 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-o 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-o na variável $Config.

O segundo comando usa o cmdlet Add-AzureHDInsightScriptAction para adicionar a ação de script especificada ao $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 ao $Config.

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

Parâmetros

-ClusterRoleCollection

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

Você pode especificar um valor ou ambos os valores.

Tipo:ClusterNodeType[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Config

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

Tipo:AzureHDInsightConfig
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Parameters

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Uri

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

Tipo:Uri
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False