Right Click Tools Builder is an automation engine that allows for the creation of strings of Right Click Tools actions, including all of the different Right Click Tools, PowerShell scripts, Registry Edits, WMI Calls, and more. These customized tools can then be saved and shared with role-based permissions. This guide will help you to understand the functions of Right Click Tools Builder and how to use them.
Right Click Tools Builder is available in a number of console locations. To open it, right click in the console and navigate to Recast Right Click Tools > Right Click Tools Builder:
First, select the "New Action" Button:
- This will create a new saved tool under the "My Right Click Tools" list.
Next, select the Start Node in the Tool Creator to populate the Action Properties box. The options in the Actions Properties section help with the design and configuration on the new tool.
The "View" field is used to determine how the results of a Right Click Tools Builder tool will be displayed. The options available are Single Grid Results, Two Grid Results, and Tabbed Results.
- Different result displays may be more desirable from a user experience perspective than others.
- Tabbed Results: shows a result for each step of the tool.
- View options do not have an effect on the successful or unsuccessful technical operation of Right Click Tools Builder tools; they only affect the way in which results are displayed.
The "Name" field determines the name of the Right Click Tools Builder tool. The save button in the upper left will populate newly named tools in the My Right Click Tools list.
The "Display" field option is used to identify the ConfigMgr object that the Right Click Tools Builder tool is being run against. Options change based on the selected Action Type.
- For a tool run against a device, the "Computer Name" option would be an appropriate display option.
The "Action" field option is used to specify what properties the tool will take action upon.
- Generic: for all Right Click Tools Builder Tools acting on functions not related to users or devices.
- Device (with or without resource ID): for tools acting on devices. These tools will be available anywhere Right Click Tools device tools are available. The Resource ID is ConfigMgr's unique identifier for a computer object.
- User (with or without Resource ID): for tools acting on users. These tools will be available anywhere Right Click Tools user tools are available. The Resource ID is ConfigMgr's unique identifier for a user object.
Input Parameters can be used to provide users with options prior to tool execution time.
- Choosing a collection to which a device will be added.
- Choosing whether or not to force a full inventory cycle upon completion.
- Having an admin input a PowerShell script.
First, select an input parameter type by choosing from the dropdown and clicking "Add". Options include:
- The Boolean input parameter will prompt the user running the action with an option to check or uncheck the parameter mapped to the Boolean.
- The DateTime input parameter will prompt the user running the action with an option to select the date and time.
- The Integer input parameter will prompt the user running the action with an option to set an integer value. You also have the option to set a default, minimum, and maximum value.
- The String input parameter gives you two options - List or Textbox. This will prompt the user running the action to select or input a string.
- The TimeSpan input parameter will prompt the user running the action with an option to set a length of time. A default value can be set if needed.
Use the Recast Actions search box or drill-down menu to find relevant tool actions. Drag actions from the Recast Actions menu into the tool creator to add them to an existing tool.
Next, direct the flow of actions from the Start node to the first action step by selecting the circle edge and dragging it to the first box:
Right Click Tools Builder will auto-select the edge arrow in blue and populate the item properties field below. Configuring and setting parameters will tell ConfigMgr what properties to change on the targeted object:
Parameters can be mapped to a constant value or a specific property or step. Constant values must be specified, whereas Parameter Mapped values can be pulled from any step of the existing tool to any property of the action being taken:
- This should be done for every parameter appropriate for the actions you are trying to take. A good rule of thumb here is to map parameters for actions where you need to pull input from the user or the properties of the object should change. Use constant values to hard code a value.
Right Click Tools Builder has the ability to set and work with conditional responses. Right Click Tools Builder can be configured to skip certain actions based on the results from previous actions. There are several logical term choices:
Once a logical condition has been added, input values can be associated. For example, an "Equal To" condition has been set from the Computer Name to a name of device "XYZ":
- If the conditions are true, Right Click Tools Runner will execute the next step according to the specified workflow. If not, the next step (and any subsequent step in the chain) will be skipped.
Once complete, be sure to save newly created tools. With the Right Click Tools Enterprise Server, Right Click Tools Builder tools are automatically saved and can be configured with Role-Based Permissions.