PowerShellOnTargetMachines@2 - PowerShell em máquinas-alvo v2 tarefa

Artigo
07/02/2024

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

Partilhar via