PowerShellOnTargetMachines@3: tarea de PowerShell en máquinas de destino v3

Use esta tarea para ejecutar scripts de PowerShell en máquinas remotas mediante PSSession y Invoke-Command para la comunicación remota.

Use esta tarea para ejecutar scripts de PowerShell en máquinas remotas. Esta versión de la tarea usa PSSession y Invoke-Command para la comunicación remota.

# PowerShell on target machines v3
# Execute PowerShell scripts on remote machines using PSSession and Invoke-Command for remoting.
- task: PowerShellOnTargetMachines@3
  inputs:
    Machines: # string. Required. Machines. 
    #UserName: # string. Username. 
    #UserPassword: # string. Password. 
  # Script options
    #ScriptType: 'Inline' # 'FilePath' | 'Inline'. Script Type. Default: Inline.
    #ScriptPath: # string. Required when ScriptType = FilePath. Script File Path. 
    InlineScript: # string. Required when ScriptType = Inline. Script. 
    #ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments. 
    #InitializationScript: # string. Optional. Use when ScriptType = FilePath. Initialization script. 
    #SessionVariables: # string. Optional. Use when ScriptType = FilePath. Session Variables. 
  # PSSession options
    #CommunicationProtocol: 'Https' # 'Http' | 'Https'. Protocol. Default: Https.
    #AuthenticationMechanism: 'Default' # 'Default' | 'Credssp'. Authentication. Default: Default.
    #NewPsSessionOptionArguments: '-SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block' # string. Session Option parameters. Default: -SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block.
  # Error handling options
    #ErrorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
    #failOnStderr: false # boolean. Fail on Standard Error. Default: false.
    #ignoreLASTEXITCODE: false # boolean. Ignore $LASTEXITCODE. Default: false.
  # Advanced
    #WorkingDirectory: # string. Working Directory. 
    #RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.

# PowerShell on Target Machines v3
# Execute PowerShell scripts on remote machine(s). This version of the task uses PSSession and Invoke-Command for remoting.
- task: PowerShellOnTargetMachines@3
  inputs:
    Machines: # string. Required. Machines. 
    #UserName: # string. Username. 
    #UserPassword: # string. Password. 
  # Script options
    #ScriptType: 'Inline' # 'FilePath' | 'Inline'. Script Type. Default: Inline.
    #ScriptPath: # string. Required when ScriptType = FilePath. Script File Path. 
    InlineScript: # string. Required when ScriptType = Inline. Script. 
    #ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments. 
    #InitializationScript: # string. Optional. Use when ScriptType = FilePath. Initialization script. 
    #SessionVariables: # string. Optional. Use when ScriptType = FilePath. Session Variables. 
  # PSSession options
    #CommunicationProtocol: 'Https' # 'Http' | 'Https'. Protocol. Default: Https.
    #AuthenticationMechanism: 'Default' # 'Default' | 'Credssp'. Authentication. Default: Default.
    #NewPsSessionOptionArguments: '-SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block' # string. Session Option parameters. Default: -SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block.
  # Error handling options
    #ErrorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
    #failOnStderr: false # boolean. Fail on Standard Error. Default: false.
    #ignoreLASTEXITCODE: false # boolean. Ignore $LASTEXITCODE. Default: false.
  # Advanced
    #WorkingDirectory: # string. Working Directory. 
    #RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.

Machines - Máquinas
string. Obligatorio.

Especifica una lista separada por comas de FQDN de máquina o direcciones IP y, opcionalmente, incluye el número de puerto. Puede ser:

• Nombre de un grupo de recursos de Azure.
• Lista delimitada por comas de nombres de máquina. Ejemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
• Variable de salida de una tarea anterior.

Si no especifica un puerto, se usa el puerto winRM predeterminado. Esto depende del protocolo que haya configurado. Para WinRM 2.0, el puerto HTTP predeterminado es 5985 y el puerto HTTPS predeterminado es 5986.

UserName - Nombre de usuario
string.

Especifica el nombre de usuario de un dominio o una cuenta administrativa local en los hosts de destino.

• Se admiten formatos como username, domain\username, machine-name\usernamey .\username .
• No se admiten formatos UPN, como username@domain.com y cuentas del sistema integradas, como NT Authority\System .

UserPassword - Contraseña
string.

Especifica la contraseña de 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.

ScriptType - Tipo de script
string. Valores permitidos: FilePath (Ruta de acceso del archivo), Inline. Valor predeterminado: Inline.

Especifica el tipo de script que se va a ejecutar: Ruta de acceso de archivo o insertada.

ScriptPath - Ruta de acceso del archivo de script
string. Obligatorio cuando ScriptType = FilePath.

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, que debe ser accesible desde la máquina de destino.

InlineScript - Guión
string. Obligatorio cuando ScriptType = Inline. Valor predeterminado: # Write your powershell commands here.\n\nWrite-Output "Hello World".

ScriptArguments - Argumentos de script
string. Opcional. Use cuando ScriptType = FilePath.

Especifica los argumentos del script de PowerShell. Puede ser parámetros ordinales o con nombre, como -testParam test. Por ejemplo: -applicationPath $(applicationPath), -username $(vmusername), -password $(vmpassword).

InitializationScript - Script de inicialización
string. Opcional. Use cuando ScriptType = FilePath.

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

SessionVariables - Variables de sesión
string. Opcional. Use cuando ScriptType = FilePath.

Se usa para configurar las variables de sesión para los scripts de PowerShell.
Especifica una lista separada por comas, como $varx=valuex, $vary=valuey. Se usa normalmente para la compatibilidad con versiones anteriores del servicio de versión. Se recomienda usar argumentos en lugar de variables de sesión.

CommunicationProtocol - Protocolo
string. Valores permitidos: Http, Https. Valor predeterminado: 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.

AuthenticationMechanism - Autenticación
string. Valores permitidos: Default, Credssp. Valor predeterminado: Default.

Especifica el mecanismo de autenticación que se usa para crear la PSSession. Para CredSSP la autenticación, los campos nombre de usuario y contraseña son obligatorios.

NewPsSessionOptionArguments - Parámetros de opción de sesión
string. Valor predeterminado: -SkipCACheck -IdleTimeout 7200000 -OperationTimeout 0 -OutputBufferingMode Block.

Opciones avanzadas para una sesión remota (New-PSSessionOption). Por ejemplo, , -SkipCACheck-SkipCNCheck, -SkipRevocationCheck, etc. Consulte una lista completa de todas las opciones de sesión para obtener más información.

ErrorActionPreference - ErrorActionPreference
string. Valores permitidos: stop, continue y silentlyContinue. Valor predeterminado: stop.

Antepone la línea $ErrorActionPreference = 'VALUE' en la parte superior del script.

failOnStderr - Error en el error estándar
boolean. Valor predeterminado: false.

Si se establece trueen , se produce un error si se escriben errores en la canalización de errores o si se escriben datos en el flujo de error estándar. De lo contrario, la tarea se basa en el código de salida para determinar el error.

ignoreLASTEXITCODE - Omitir $LASTEXITCODE
boolean. Valor predeterminado: false.

Si se establece en false, la línea if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE } se ejecuta al final del script. Esto hace que el último código de salida de un comando externo se propague como código de salida de PowerShell. De lo contrario, la línea no se ejecuta al final del script.

WorkingDirectory - Directorio de trabajo
string.

Especifica el directorio de trabajo donde se ejecuta el script.

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.

Ninguno.