Inspecting tasks
Sections
Before you run a task in your environment, inspect the task to determine what effect it has on your targets.
Run in no operation mode
You can run some tasks in no-operation mode (noop
) to view changes without
taking any action on your targets. This way, you ensure the tasks perform as
designed. If a task doesn't support no-operation mode, you get an error.
-
*nix shell command
bolt task run package name=vim action=install --noop --targets example.com
Copied! -
PowerShell cmdlet
Invoke-BoltTask -Name package -Noop --Targets example.com name=vim action=install
Copied!
Show a task list
View a list of what tasks are installed in the current modulepath. Note that
tasks marked with the private
metadata key are not shown:
-
*nix shell command
bolt task show
Copied! -
PowerShell cmdlet
Get-BoltTask
Copied!
Show documentation for a task
View parameters and other details for a task, including whether a task supports
noop
:
-
*nix shell command
bolt task show <TASK NAME>
Copied! -
PowerShell cmdlet
Get-BoltTask -Name <TASK NAME>
Copied!
📖 Related information
For more information on the modulepath, see Modules overview.