Run Puppet on demand from the CLI

Use the puppet job run command to start an on-demand Puppet run to enforce changes on your agent nodes.

Use the puppet job run command to immediately enforce change across nodes, rather than waiting for the next scheduled Puppet run. For example, if you add a new class parameter to a set of nodes, or if you deploy code to a new Puppet environment, you might want to use this command to run Puppet across all the nodes in the impacted environment.

Each time you use the puppet job run command, you can select one, and only one, of these targets:

• A list of one or more specific nodes, identified by certname.
• A node group, identified by node group ID.
• A Puppet Query Language (PQL) query defining a set of nodes.

The first time you run a command, you need to authenticate. For details, refer to Setting PE RBAC permissions and token authentication for orchestrator .

If you're running this command from a managed or non-managed Windows workstation, you must specify the full path to the command. For example: c:\Program Files\Puppet Labs\Client\bin\puppet-task run