runbook params description

Ishai Shahak 1 Reputation point
2021-07-14T08:11:23.69+00:00

Hey,

How can I add description/help to runbook parameters?
something like:

disk_type (description: choose between HDD and SSD)

Azure Virtual Machines
Azure Virtual Machines
An Azure service that is used to provision Windows and Linux virtual machines.
7,875 questions
Azure Automation
Azure Automation
An Azure service that is used to automate, configure, and install updates across hybrid environments.
1,256 questions
0 comments No comments
{count} votes

1 answer

Sort by: Most helpful
  1. tbgangav-MSFT 10,416 Reputation points
    2021-07-14T15:31:41.947+00:00

    Hi @Ishai Shahak ,

    Currently while configuring input parameters in runbook, there is no property called as "Description" or "HelpMessage" but we only have "Name", "Type", "Mandatory" and "DefaultValue" as properties.

    So if interested, you may upvote this and/or this related uservoice feature requests. In general, Azure feature team would check feasibility of a feature request, prioritize against existing feature backlog, add in roadmap as appropriate and would announce and/or update the related Azure document once a feature request is addressed.

    Until the above feature request is implemented, as a workaround, I would recommend you to leverage "DefaultValue" property along with setting "Mandatory" property as true so that the person who executes the runbook in mandatory checks the parameter and hopefully updates it as appropriate.

    To illustrate, have your param section as shown in below code block and screenshots.

    Param  
    (  
      [Parameter (Mandatory= $true)]  
      [String] $DiskType = "IMP! - Update default value as either HDD or SSD",  
    )  
    "test"  
    

    114617-image.png
    114664-image.png

    1 person found this answer helpful.

Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.