Share via

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.

Azure Automation
Azure Automation

An Azure service that is used to automate, configure, and install updates across hybrid environments.

0 comments No comments

1 answer

Sort by: Most helpful
  1. tbgangav-MSFT 10,431 Reputation points Moderator
    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' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.