For the complete documentation index, see llms.txt. This page is also available as Markdown.

Invoke-PSUWorkflow

Invoke-PSUWorkflow ejecuta un flujo de trabajo configurado de PowerShell Universal por nombre, Id u objeto de flujo de trabajo.

SINOPSIS

Ejecuta un flujo de trabajo en PowerShell Universal.

SINTAXIS

Invoke-PSUWorkflow -Name <String> [-Parameters <Hashtable>] [-Environment <String>] [-Queue <String>] [-Wait] [-WaitTimeout <Int32>] [<ExecutionOptions>] [<ConnectionOptions>]
Invoke-PSUWorkflow -Id <Int64> [-Parameters <Hashtable>] [<ExecutionOptions>] [<ConnectionOptions>]
Invoke-PSUWorkflow -Workflow <Workflow> [-Parameters <Hashtable>] [<ExecutionOptions>] [<ConnectionOptions>]

<ExecutionOptions>: [-WaitForDebugger] [-Environment <String>] [-Notes <String>] [-Credential <Variable>] [-Wait] [-Queue <String>] [-WaitTimeout <Int32>] [-Tags <Tag[]>] [-Silent]. <ConnectionOptions>: [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]. Aquí, -Credential es una variable de credencial de PSU para la ejecución del flujo de trabajo, no las credenciales básicas de la API de administración.

DESCRIPCIÓN

Ejecuta un flujo de trabajo configurado seleccionado por nombre, Id u objeto de flujo de trabajo (acepta la entrada de la canalización). Suministre las entradas declaradas del flujo de trabajo mediante -Parameters: los nombres desconocidos producen un error. Reemplace el entorno de ejecución o la cola y, de forma opcional, espere a que finalice. Con -Wait, el cmdlet delega en Wait-PSUJob; de lo contrario, devuelve el trabajo creado.

EJEMPLOS

Invoke-PSUWorkflow -Name 'DailyMaintenance'
Invoke-PSUWorkflow -Name 'Deploy' -Parameters @{ Environment = 'Test' } -Wait

PARÁMETROS

Parámetro
Descripción

-Name

Nombre de flujo de trabajo obligatorio en el conjunto de parámetros predeterminado; sin distinguir mayúsculas de minúsculas.

-Id

Id numérico de flujo de trabajo obligatorio en el conjunto de parámetros Id.

-Workflow

Objeto de flujo de trabajo; acepta la entrada de la canalización.

-Parameters

Tabla hash de los valores de entrada declarados del flujo de trabajo; los nombres de parámetros desconocidos producen un error.

-Environment

Reemplazo del entorno de ejecución (alias -PowerShellVersion).

-Queue

Cola de ejecución o grupo de ordenadores (alias -ComputerGroup).

-Wait

Espera a que finalice el trabajo del flujo de trabajo.

-WaitTimeout

Tiempo de espera en segundos utilizado durante la espera; un valor omitido o cero deja la espera sin esta sustitución del tiempo de espera.

-WaitForDebugger

Espera a que se conecte un depurador antes de la ejecución.

-Notes

Notas adjuntas al trabajo del flujo de trabajo.

-Credential

Variable de credencial de PSU utilizada para la ejecución.

-Tags

Etiquetas adjuntas al trabajo.

-Silent

Suprime la salida de la operación de espera.

-ComputerName

URL o nombre de host de la API de administración de PSU (alias -Uri).

-AppToken

Token de aplicación de la API de administración.

-UseDefaultCredentials

Usa las credenciales actuales de Windows.

-Integrated

Usa el cliente de administración en proceso.

-TrustCertificate

Ignora los errores de validación del certificado.

-Cookies

Reutiliza las cookies de autenticación de la sesión.

ENLACES RELACIONADOS

PERMISOS

El token de acceso requiere automation.workflows/execute para ejecutar este cmdlet de forma remota. Recuperar primero un flujo de trabajo con Get-PSUWorkflow también requiere automation.workflows/read.

Última actualización

¿Te fue útil?