PowerShellOnTargetMachines@1 – Tarefa Do PowerShell em Computadores de Destino v1

Artigo
07/02/2024

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

Syntax

# PowerShell on Target Machines v1
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@1
  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 de administrador
string.

Especifica o logon do administrador para os computadores de destino.

AdminPassword - Senha
string.

Especifica a senha do 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 WinRM com os computadores. O valor padrão é HTTPS.

TestCertificate - Testar certificado
boolean. Opcional. Use quando Protocol = Https. Valor padrão: true.

Ignora 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 de computador ou marcas.

MachineNames - Critérios de Filtro
string.

Essa entrada é válida somente 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 da 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.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda 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 da tarefa	Implantar

Compartilhar via