Partilhar via


PowerShellOnTargetMachines@2 - Tarefa PowerShell em Máquinas de Destino v2

Use esta tarefa para executar scripts do PowerShell na(s) máquina(s) remota(s).

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.

Insumos

EnvironmentName - Máquinas
string. Obrigatório.

Especifica uma lista separada por vírgulas de endereços IP ou FQDNs da máquina, 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 da máquina deve corresponder ao CN no certificado.


AdminUserName - de login de administrador
string.

Especifica o login de administrador para as máquinas de destino.
Por exemplo: Domain\Admin User, Admin User@Domain, .\Admin User.


AdminPassword - Palavra-passe
string.

Especifica a senha de administrador para as máquinas de destino. As variáveis definidas nas definições de compilação/versão como $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-la.


Protocol - Protocolo
string. Valores permitidos: Http, Https.

Especifica o protocolo a ser usado para a conexão de serviço do WinRM com a(s) máquina(s). O valor predefinido é 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 da máquina por uma autoridade de certificação confiável. O parâmetro é necessário para o protocolo HTTPS do WinRM.


ScriptPath - PowerShell Script
string. Obrigatório.

Especifica o local do script do PowerShell nas máquinas 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. Podem ser parâmetros ordinais ou nomeados, como -testParam teste.


InitializationScriptPath - de script de inicialização
string.

Especifica o local do script de dados para DSC nas máquinas 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 nas máquinas de destino.


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

Opcional. Especifica um subconjunto de máquinas fornecendo nomes de máquinas ou tags.


MachineNames - Critérios de Filtro
string.

Esta entrada é válida apenas para grupos de máquinas ou variáveis de saída. Ainda não é suportado para uma lista simples de máquinas.

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


Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

O que há de novo na versão 2.0:

  • Removido o suporte de máquinas DTL herdadas.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.104.0 ou superior
Categoria de tarefa Desplegar