Remove-AppVentiXPublishingTask

Removes one or more AppVentiX publishing tasks.

Syntax 

# Parameter Set: ID
Remove-AppVentiXPublishingTask
    -Id <String[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

# Parameter Set: MachineGroupFriendlyname
Remove-AppVentiXPublishingTask
    -MachineGroupFriendlyname <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Remove-AppVentiXPublishingTask function removes one or more publishing tasks from AppVentiX. Tasks can be removed by their unique ID or by machine group friendly name. Because this is a destructive operation, confirmation is required unless -Force is specified. The function supports -WhatIf and -Confirm common parameters.

Parameters

-Id

One or more publishing task IDs to remove. Accepts an array of ID strings.

   
Type: String[]
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False

-MachineGroupFriendlyname

The friendly name of the machine group whose publishing tasks should be removed.

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

-Force

Suppresses the confirmation prompt and removes tasks without asking for confirmation.

   
Type: SwitchParameter
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the command runs without actually performing the removal.

   
Type: SwitchParameter
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts for confirmation before executing the removal.

   
Type: SwitchParameter
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

Examples

Example 1: Remove a publishing task by ID 

Remove-AppVentiXPublishingTask -Id "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Removes the publishing task with the specified ID after confirmation.

Example 2: Remove multiple publishing tasks without confirmation 

Remove-AppVentiXPublishingTask -Id "id1", "id2", "id3" -Force

Removes the specified publishing tasks without prompting for confirmation.

Example 3: Remove all tasks for a machine group 

Remove-AppVentiXPublishingTask -MachineGroupFriendlyname "Development" -Force

Removes all publishing tasks assigned to the Development machine group without confirmation.

Example 4: Preview removal with WhatIf 

Remove-AppVentiXPublishingTask -MachineGroupFriendlyname "Production" -WhatIf

Shows which publishing tasks would be removed for the Production machine group without actually removing them.

Notes

  • Requires a valid AppVentiX license
  • This operation is irreversible; use -WhatIf to preview changes before executing