New-PSUWorkflowActivity

SYNOPSIS

Erstellt eine Workflow-Aktivitätsdefinition.

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

Erstellt eine Workflow-Aktivitätsdefinition, die in den -Definition-Skriptblock von New-PSUWorkflow eingebettet werden kann. Der Aktivitätstyp bestimmt, welche Eigenschaften verfügbar sind. Für integrierte und skriptbasierte Aktivitäten kann das Cmdlet dynamische Parameter basierend auf dem ausgewählten -Type und dem optionalen -ScriptFullPath bereitstellen. Verwenden Sie -Parameters, um literale Eigenschaftswerte zu übergeben, und -Expressions, um PowerShell-Ausdrücke zuzuweisen, wenn eine Eigenschaft zur Laufzeit ausgewertet werden soll, anstatt als fester Wert serialisiert zu werden.

EXAMPLES

Beispiel 1

PS C:\> New-PSUWorkflowActivity -Type Flowchart

Erstellt eine einfache Flussdiagramm-Aktivitätsdefinition, die als Root-Aktivität eines Workflows verwendet werden kann.

Beispiel 2

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

Erstellt eine Skriptaktivität und bindet dynamische Parameter aus den Metadaten der skriptbasierten Workflow-Aktivität.

Beispiel 3

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

Erstellt eine Container-Aktivität und stellt verschachtelte Aktivitäten über die -Parameters-Hashtabelle bereit.

PARAMETERS

-AppToken

Gibt das App-Token an, das für die Authentifizierung bei der PowerShell Universal-Verwaltungs-API verwendet werden soll.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

Gibt die URL oder den Hostnamen der Ziel-PowerShell Universal-Instanz an. Reine Hostnamen werden zu einer http://<host>:5000-URL normalisiert.

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

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

-Cookies

Verwendet und speichert Authentifizierungscookies für die aktuelle PowerShell-Sitzung.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

Gibt die Anmeldeinformationen an, die für die Basic-Authentifizierung gegenüber der PowerShell Universal-Verwaltungs-API verwendet werden sollen.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Expressions

Gibt Aktivitätseigenschaftswerte als PowerShell-Ausdrücke an. Verwenden Sie diese Hashtabelle, wenn die Zieleigenschaft der Aktivität einen Ausdruck zur Laufzeit ausführen soll, anstatt einen serialisierten literalen Wert zu speichern.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-Integrated

Verwendet den prozessinternen integrierten Verwaltungsclient, wenn das Cmdlet innerhalb von PowerShell Universal ausgeführt wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Gibt den Aktivitätsnamen an, der der generierten Workflow-Aktivitätsdefinition zugewiesen werden soll.

Type: String
Parameter Sets: (All)
Aliases:

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

-Parameters

Gibt literale Aktivitätseigenschaftswerte an. Jeder Schlüssel muss einer gültigen Eigenschaft des ausgewählten Aktivitätstyps entsprechen.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-ScriptFullPath

Gibt den vollständigen Pfad des Skripts an, wenn -Type Script verwendet wird. Das Cmdlet verwendet diesen Pfad, um skriptbasierte Aktivitätsmetadaten und dynamische Parameter aufzulösen.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Erlaubt Verbindungen zu Servern mit nicht vertrauenswürdigen TLS-Zertifikaten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Type

Gibt den zu erstellenden Workflow-Aktivitätstyp an, z. B. Flowchart, Sequence oder Script. Der ausgewählte Typ bestimmt, welche dynamischen Parameter und Eigenschaften verfügbar sind.

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Verwendet die aktuellen Windows-Anmeldeinformationen für die Authentifizierung bei der Verwaltungs-API.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter about_CommonParameters.

INPUTS

Keine

OUTPUTS

PowerShellUniversal.Models.Workflows.WorkflowActivityDefinition

NOTES

RELATED LINKS

New-PSUWorkflow