New-PSUWorkflowActivity

SYNOPSIS

Crea una definición de actividad de flujo de trabajo.

SYNTAX

New-PSUWorkflowActivity [-Type] <String> [-Name <String>] [-ScriptFullPath <String>] [-Parameters <Hashtable>]
 [-Expressions <Hashtable>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

DESCRIPTION

Crea una definición de actividad de flujo de trabajo que se puede incrustar en el bloque de script -Definition de New-PSUWorkflow. El tipo de actividad controla qué propiedades están disponibles. Para las actividades integradas y basadas en scripts, el cmdlet puede exponer parámetros dinámicos según el -Type seleccionado y el -ScriptFullPath opcional. Use -Parameters para pasar valores de propiedad literales y -Expressions para asignar expresiones de PowerShell cuando una propiedad deba evaluarse en tiempo de ejecución en lugar de serializarse como un valor fijo.

EXAMPLES

Ejemplo 1

PS C:\> New-PSUWorkflowActivity -Type Flowchart

Crea una definición sencilla de actividad de diagrama de flujo que se puede utilizar como actividad raíz de un flujo de trabajo.

Ejemplo 2

PS C:\> New-PSUWorkflowActivity -Type Script -ScriptFullPath 'C:\ProgramData\UniversalAutomation\Repository\scripts\Deploy.ps1' -Name 'Deploy' -FailOnScriptError $true -DeconstructHashtableOutput $true

Crea una actividad de script y enlaza parámetros dinámicos a partir de los metadatos de la actividad de flujo de trabajo basada en scripts.

Ejemplo 3

PS C:\> New-PSUWorkflowActivity -Type Sequence -Parameters @{ Activities = @(
>>     New-PSUWorkflowActivity -Type Flowchart
>> ) }

Crea una actividad de contenedor y proporciona actividades anidadas a través de la tabla hash -Parameters.

PARAMETERS

-AppToken

Especifica el token de aplicación que se debe utilizar al autenticarse en la API de administración de PowerShell Universal.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

Especifica la URL o el nombre de host de la instancia de PowerShell Universal de destino. Los nombres de host simples se normalizan a una URL http://<host>:5000.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Especifica las credenciales que se deben utilizar para la autenticación básica frente a la API de administración de PowerShell Universal.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Expressions

Especifica los valores de las propiedades de la actividad como expresiones de PowerShell. Use esta tabla hash cuando la propiedad de actividad de destino deba ejecutar una expresión en tiempo de ejecución en lugar de almacenar un valor literal serializado.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Utiliza el cliente de administración integrado en proceso cuando el cmdlet se ejecuta dentro de PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Especifica el nombre de actividad que se asignará a la definición de actividad de flujo de trabajo generada.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Parameters

Especifica valores literales de propiedades de la actividad. Cada clave debe coincidir con una propiedad válida para el tipo de actividad seleccionado.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScriptFullPath

Especifica la ruta completa del script cuando se utiliza -Type Script. El cmdlet utiliza esta ruta para resolver los metadatos de la actividad basada en scripts y los parámetros dinámicos.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Permite conexiones a servidores con certificados TLS no confiables.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Type

Especifica el tipo de actividad de flujo de trabajo que se debe crear, como Flowchart, Sequence o Script. El tipo seleccionado determina qué parámetros dinámicos y propiedades están disponibles.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Utiliza las credenciales actuales de Windows al autenticarse en la API de administración.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para obtener más información, consulte about_CommonParameters.

INPUTS

Ninguno

OUTPUTS

PowerShellUniversal.Models.Workflows.WorkflowActivityDefinition

NOTES

RELATED LINKS

New-PSUWorkflow