PowerShellOnTargetMachines@2: tarea PowerShell en máquinas de destino v2

Artículo
07/02/2024

Use esta tarea para ejecutar scripts de PowerShell en máquinas remotas.

Sintaxis

# 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. Obligatorio.

Especifica una lista separada por comas de direcciones IP de máquina o FQDN, junto con puertos. El puerto predeterminado se basa en el protocolo seleccionado.
Por ejemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
También puede proporcionar la variable de salida de otras tareas, por ejemplo $(variableName). Si usa HTTPS, el nombre o la dirección IP de la máquina deben coincidir con el CN en el certificado.

AdminUserName - inicio de sesión de Administración
string.

Especifica el inicio de sesión de administrador para las máquinas de destino.
Por ejemplo: Domain\Admin User, Admin User@Domain, .\Admin User.

AdminPassword - Contraseña
string.

Especifica la contraseña de administrador para las máquinas de destino. Las variables definidas en las definiciones de compilación o versión tal como $(passwordVariable) se aceptan. Puede marcar el tipo de variable como secret para protegerlo.

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

Especifica el protocolo que se va a usar para la conexión del servicio WinRM con las máquinas. El valor predeterminado es HTTPS.

TestCertificate - Certificado de prueba
boolean. Opcional. Use cuando Protocol = Https. Valor predeterminado: true.

Especifica la opción para omitir la validación de la autenticidad del certificado de la máquina mediante una entidad de certificación de confianza. El parámetro es necesario para el protocolo HTTPS de WinRM.

ScriptPath - PowerShell Script
string. Obligatorio.

Especifica la ubicación del script de PowerShell en las máquinas de destino o en una ruta de acceso UNC, como C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - Argumentos de script
string.

Especifica los argumentos del script de PowerShell. Puede ser parámetros ordinales o con nombre, como -testParam test.

InitializationScriptPath - Script de inicialización
string.

Especifica la ubicación del script de datos para DSC en las máquinas de destino o en una ruta de acceso UNC, como C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - Variables de sesión
string.

Especifica las variables de sesión comunes para ambos scripts. Por ejemplo, $variable = value o $var1 = "value, 123".

RunPowershellInParallel - Ejecución de PowerShell en paralelo
boolean. Valor predeterminado: true.

Si se establece trueen , ejecuta los scripts de PowerShell en paralelo en las máquinas de destino.

ResourceFilteringMethod - Seleccionar máquinas por
string. Valores permitidos: machineNames (Nombres de máquina), tags. Valor predeterminado: machineNames.

Opcional. Especifica un subconjunto de máquinas proporcionando nombres de máquina o etiquetas.

MachineNames - Criterios de filtro
string.

Esta entrada solo es válida para grupos de máquinas o variables de salida. Todavía no es compatible con una lista plana de máquinas.

Especifica una lista de máquinas, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 o etiquetas, como Role:DB; OS:Win8.1. Si se especifican varias etiquetas, la tarea se ejecutará en todas las máquinas con las etiquetas especificadas. El valor predeterminado ejecuta la tarea en todas las máquinas.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Novedades de la versión 2.0:

Se ha quitado la compatibilidad de las máquinas DTL heredadas.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	Ninguno
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.104.0 o superior
Categoría de la tarea:	Implementación

Compartir a través de