PowerShellOnTargetMachines@2 - PowerShell em máquinas-alvo v2 tarefa
Utilize esta tarefa para executar scripts PowerShell em máquinas remotas.
Syntax
# 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ório.
Especifica uma lista separada por vírgula de endereços IP ou FQDNs da máquina, juntamente com portas. A porta predefinida baseia-se no protocolo selecionado.
Por exemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Também pode fornecer a variável de saída de outras tarefas, por exemplo $(variableName)
. Se estiver a utilizar HTTPS, o nome ou IP da máquina deve coincidir com o CN no certificado.
AdminUserName
- Administração Início de Sessão
string
.
Especifica o login do administrador para as máquinas-alvo.
Por exemplo: Domain\Admin User
. Admin User@Domain
. .\Admin User
. .
AdminPassword
- Senha
string
.
Especifica a palavra-passe do administrador para as máquinas-alvo. Variáveis definidas nas definições de construção/libertação, conforme $(passwordVariable)
são aceites. Pode marcar o tipo variável para secret
o fixar.
Protocol
- Protocolo
string
. Valores permitidos: Http
. Https
. .
Especifica o protocolo a utilizar para a ligação de serviço WinRM com a(s) máquina(s). O valor predefinido é HTTPS
.
TestCertificate
- Certificado de teste
boolean
. Opcional. Utilizar quando Protocol = Https
. Valor predefinido: true
.
Especifica a opção de não validar a autenticidade do certificado da máquina por uma autoridade de certificação fidedigna. O parâmetro é necessário para o protocolo WinRM HTTPS.
ScriptPath
- Roteiro PowerShell
string
. Obrigatório.
Especifica a localização do script PowerShell nas máquinas-alvo ou num caminho unc, como C:\BudgetIT\Web\Deploy\Website.ps1
.
ScriptArguments
- Argumentos de script
string
.
Especifica os argumentos para o script PowerShell. Pode ser ordinal ou nomeado parâmetros, como -testParam
o teste.
InitializationScriptPath
- Roteiro de inicialização
string
.
Especifica a localização do roteiro de dados para DSC nas máquinas-alvo ou num 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 PowerShell em Paralelo
boolean
. Valor predefinido: true
.
Se estiver definido true
, executa os scripts PowerShell em paralelo nas máquinas-alvo.
ResourceFilteringMethod
- Selecione máquinas por
string
. Valores permitidos: machineNames
(Nomes de máquinas), tags
. Valor predefinido: machineNames
.
Opcional. Especifica um subconjunto de máquinas fornecendo nomes ou etiquetas de máquinas.
MachineNames
- Critérios de filtragem
string
.
Esta entrada é válida apenas para grupos de máquinas ou variáveis de saída. Ainda não é suportado para uma lista plana de máquinas.
Especifica uma lista de máquinas, gostos dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34
ou tags, como Role:DB; OS:Win8.1
. Se forem especificadas várias tags, a tarefa será executada em todas as máquinas com as etiquetas 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 controlo para além das entradas de tarefa. Para obter mais informações, consulte opções de Controlo e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
Novidades na versão 2.0:
- Removido suporte de máquinas DTL antigas.
Requisitos
Requisito | Description |
---|---|
Tipos de gasodutos | YAML, Construção clássica, lançamento clássico |
Continua | Agente, Grupo de Implementação |
Exigências | Nenhuma |
Capacidades | Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis de configuração | Qualquer |
Versão do agente | 1.104.0 ou maior |
Categoria da tarefa | Implementação |
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários