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

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 - Machines
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.

de inicio de sesión de administrador de AdminUserName -
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.

de contraseña de AdminPassword -
string.

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

de protocolo Protocol -
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 - de certificado de prueba
boolean. Opcional. Use cuando Protocol = Https. Valor predeterminado: true.

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

ScriptPath - de script de PowerShell
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.

argumentos de script de ScriptArguments -
string.

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

script de inicialización de InitializationScriptPath -
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 - ejecutar PowerShell en en paralelo
boolean. Valor predeterminado: true.

Si se establece en true, 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. Aún no se admite para 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 tarea. Para obtener más información, consulte 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
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	1.104.0 o superior
Categoría de tarea	Desplegar