New-PSUWorkflowActivity

SYNOPSIS

Crée une définition d'activité de flux de travail.

SYNTAXE

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

DESCRIPTION

Crée une définition d'activité de flux de travail qui peut être intégrée dans le bloc de script -Definition de New-PSUWorkflow. Le type d'activité détermine quelles propriétés sont disponibles. Pour les activités intégrées et celles reposant sur un script, l'applet de commande peut exposer des paramètres dynamiques selon le -Type sélectionné et le -ScriptFullPath facultatif. Utilisez -Parameters pour passer des valeurs de propriété littérales et -Expressions pour affecter des expressions PowerShell lorsqu'une propriété doit être évaluée à l'exécution au lieu d'être sérialisée comme valeur fixe.

EXEMPLES

Exemple 1

PS C:\> New-PSUWorkflowActivity -Type Flowchart

Crée une définition d'activité d'organigramme simple qui peut être utilisée comme activité racine d'un flux de travail.

Exemple 2

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

Crée une activité de script et lie les paramètres dynamiques à partir des métadonnées de l'activité de flux de travail reposant sur un script.

Exemple 3

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

Crée une activité de conteneur et fournit des activités imbriquées au moyen de la table de hachage -Parameters.

PARAMÈTRES

-AppToken

Spécifie le jeton d'appli à utiliser lors de l'authentification auprès de l'API de gestion 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

Spécifie l'URL ou le nom d'hôte de l'instance PowerShell Universal cible. Les noms d'hôte simples sont normalisés en une 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

Réutilise et conserve les témoins d'authentification pour la session PowerShell en cours.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

Spécifie les identifiants à utiliser pour l'authentification de base auprès de l'API de gestion 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

Spécifie les valeurs de propriété d'activité sous forme d'expressions PowerShell. Utilisez cette table de hachage lorsque la propriété d'activité cible doit exécuter une expression à l'exécution au lieu de stocker une valeur littérale sérialisée.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-Integrated

Utilise le client de gestion intégré en cours de processus lorsque l'applet de commande s'exécute dans PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Spécifie le nom d'activité à attribuer à la définition d'activité de flux de travail générée.

Type: String
Parameter Sets: (All)
Aliases:

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

-Parameters

Spécifie les valeurs littérales de propriété d'activité. Chaque clé doit correspondre à une propriété valide pour le type d'activité sélectionné.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-ScriptFullPath

Spécifie le chemin complet du script lorsque -Type Script est utilisé. L'applet de commande utilise ce chemin pour résoudre les métadonnées d'activité reposant sur un script et les paramètres dynamiques.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Permet les connexions aux serveurs dont les certificats TLS ne sont pas approuvés.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Type

Spécifie le type d'activité de flux de travail à créer, tel que Flowchart, Sequence ou Script. Le type sélectionné détermine quels paramètres dynamiques et propriétés sont disponibles.

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Utilise les identifiants Windows actuels lors de l'authentification auprès de l'API de gestion.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'information, consultez about_CommonParameters.

ENTRÉES

Aucune

SORTIES

PowerShellUniversal.Models.Workflows.WorkflowActivityDefinition

REMARQUES

LIENS CONNEXES

New-PSUWorkflow