tarefa PowerShellOnTargetMachines@2 – PowerShell em Computadores de Destino v2

Use esta tarefa para executar scripts do PowerShell em computadores remotos.

Sintaxe

# PowerShell on Target Machines v2
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@2
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    ScriptPath: # string. Required. PowerShell Script. 
    #ScriptArguments: # string. Script Arguments. 
    #InitializationScriptPath: # string. Initialization Script. 
    #SessionVariables: # string. Session Variables. 
  # Advanced Options
    #RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

Entradas

EnvironmentName - Máquinas
string. Obrigatórios.

Especifica uma lista separada por vírgulas de endereços IP do computador ou FQDNs, juntamente com portas. A porta padrão é baseada no protocolo selecionado.
Por exemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Você também pode fornecer a variável de saída de outras tarefas, por exemplo $(variableName). Se você estiver usando HTTPS, o nome ou IP do computador deverá corresponder ao CN no certificado.


AdminUserName - Logon do Administração
string.

Especifica o logon do administrador para os computadores de destino.
Por exemplo: Domain\Admin User, Admin User@Domain, .\Admin User.


AdminPassword - Senha
string.

Especifica a senha de administrador para os computadores de destino. Variáveis definidas em definições de build/versão conforme $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-lo.


Protocol - Protocolo
string. Valores Permitidos: Http e Https.

Especifica o protocolo a ser usado para a conexão do serviço WinRM com os computadores. O valor padrão é HTTPS.


TestCertificate - Certificado de Teste
boolean. Opcional. Use quando Protocol = Https. Valor padrão: true.

Especifica a opção de ignorar a validação da autenticidade do certificado do computador por uma autoridade de certificação confiável. O parâmetro é necessário para o protocolo HTTPS do WinRM.


ScriptPath - PowerShell Script
string. Obrigatórios.

Especifica o local do script do PowerShell nos computadores de destino ou em um caminho UNC, como C:\BudgetIT\Web\Deploy\Website.ps1.


ScriptArguments - Argumentos de script
string.

Especifica os argumentos para o script do PowerShell. Pode ser parâmetros ordinais ou nomeados, como -testParam teste.


InitializationScriptPath - Script de inicialização
string.

Especifica o local do script de dados para DSC nos computadores de destino ou em um caminho UNC, como C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.


SessionVariables - Variáveis de sessão
string.

Especifica as variáveis de sessão comuns para ambos os scripts. Por exemplo, $variable = value ou $var1 = "value, 123".


RunPowershellInParallel - Executar o PowerShell em Paralelo
boolean. Valor padrão: true.

Se definido como true, executa os scripts do PowerShell em paralelo nos computadores de destino.


ResourceFilteringMethod - Selecionar Computadores por
string. Valores permitidos: machineNames (Nomes de Máquina), tags. Valor padrão: machineNames.

Opcional. Especifica um subconjunto de computadores fornecendo nomes ou marcas de computador.


MachineNames - Critérios de Filtro
string.

Essa entrada é válida apenas para grupos de computadores ou variáveis de saída. Ainda não há suporte para uma lista simples de computadores.

Especifica uma lista de computadores, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 ou marcas, como Role:DB; OS:Win8.1. Se várias marcas forem especificadas, a tarefa será executada em todos os computadores com as marcas especificadas. O padrão executa a tarefa em todos os computadores.


Opções de controle de tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Novidades na versão 2.0:

  • Foi removido o suporte de computadores DTL herdados.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
É executado em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.104.0 ou superior
Categoria da tarefa Implantar