Actions#

Actions are effectively “commands” for AME Wizard to execute, and are written in YAML using the camelCase naming convention (ex. appx, scheduledTask).

To get started using actions, follow our Getting Started guide.

Optional Parameters#


All actions have the following optional parameters.

Paramater

Description

Type

Default

weight

Specifies how much impact the action will have on the progress bar once completed.

integer

2-5 for most actions

ignoreErrors

Specifies to ignore any errors that occur while running the action.

bool

false

option

See Features In YAML.

string

None

options

Similar to option, however multiple options can be specified to trigger an action.

string array

None

builds

Specifies which Windows builds the action should apply to.

Builds can be specified using either a basic array of builds (ex. builds: ['22621', '22622']), or more dynamic versions can be specified like in the following example: builds: [ '>=22621' ]

Any of the following conditions can be used:
>= - less than or equal to
<= - greater than or equal to
> - greater than
< - less than

You can also use negative expressions like in the following example: builds: [ '>=22621', '!>22625' ].
You can also specify an update build release number: 22621.1265.

string array

None

cpuArch

Specifies to only run an action if the specified architecture matches the system architecture.

string
Must match a value from here. (Ex. “X64”)

None

Navigate to an action below for examples and/or parameters.

Actions overview#

  • RunAction: runs a specified executable or file.

  • RegistryKey: adds or deletes a specified registry key.

  • RegistryValue: modifies a specified registry value.

  • Appx: removes, or clears the cache of a given APPX component.

  • Service: executes a specified cmd command.

  • ScheduledTask: deletes a task folder, or modifies a specific task.

  • TaskKill: terminates a specified process.

  • SystemPackage: removes a specified Windows component.

  • Cmd: executes a specified cmd command.

  • PowerShell: executes a specified PowerShell command.

  • WriteStatus: writes a status message for AME Wizard.