Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use essa tarefa para executar scripts do PowerShell em computadores remotos.
Sintaxe
# 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
máquinas EnvironmentName -
string. Obrigatório
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 o IP do computador deverá corresponder ao CN no certificado.
de Logon do Administrador do AdminUserName -
string.
Especifica o logon do administrador para os computadores de destino.
AdminPassword
-
de senha
string.
Especifica a senha do administrador para os computadores de destino. Variáveis definidas em definições de build/versão como $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-lo.
de Protocolo Protocol -
string. Valores permitidos: Http, Https.
Especifica o protocolo a ser usado para a conexão WinRM com os computadores. O valor padrão é HTTPS.
TestCertificate
-
de certificado de teste
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
-
script do PowerShell
string. Obrigatório
Especifica o local do script do PowerShell nos computadores de destino ou em um caminho UNC, como C:\BudgetIT\Web\Deploy\Website.ps1.
argumentos de script ScriptArguments -
string.
Especifica os argumentos para o script do PowerShell. Podem 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.
variáveis de sessão SessionVariables -
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 paralela
boolean. Valor padrão: true.
Se definido como true, executará os scripts do PowerShell em paralelo nos computadores de destino.
ResourceFilteringMethod
-
selecionar computadores
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.
critérios de filtro de MachineNames -
string.
Essa entrada é válida apenas para grupos de máquinas 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 das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as 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 |
| Execuções em | Agent, DeploymentGroup |
| de demandas | Nenhum |
| recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| restrições de comando | Qualquer |
| variáveis settable | Qualquer |
| Versão do agente | 1.104.0 ou superior |
| Categoria de tarefa | Implantar |