This tutorial runbook demonstrates how to use input parameters in an Azure Automation runbook.  It also shows how to specify whether parameters are required, provide default parameter values and use parameters values later in the workflow. 



This runbook does not use any external systems, Automation Assets, or any other runbooks. 


Runbook Content

The runbook's content is displayed below: 


PowerShell Workflow
    Takes different types of input parameters and outputs them.   
    This runbook demonstrates how to use input parameters for runbooks. 
    It also illustrates how to specify whether parameters are required, provide default parameter values, 
    and use parameter values later in the workflow. 
    String name entered to print as output 
    Int number to be used to print as output 
.PARAMETER StringArray 
    Array of strings used to loop through and print as output.  
    An example of valid input is: [1,'astringvalue'2'anotherStringValue']  
    DateTime selected by the user used to print as the date entered 
    Boolean True/False value used to determine whether or not to print goodbye.    
    Author: System Center Automation Team  
    Last Updated: 3/3/2014    
workflow Use-RunbookParameterSample 
    # Specify input parameters here 
    param ( 
        # Optional parameter of type Stringdefault value "World" 
        [string]$Name = "World", 
        # Mandatory parameter of type int 
        # Optional parameter of type string array 
        # When starting a runbook through the GUI, separate array values with a comma as you would 
        # in json: [1,'astringvalue'] 
        # Mandatory parameter of type DateTime 
        # Mandatory parameter of type boolean 
    # Print output based on input parameter values 
    "Hello $Name" 
    "You entered the number $Number" 
    # Print each item in string array 
    foreach ($Elem in $StringArray){ 
    # Print the DateTime value 
    # Only print "Goodbye" if boolean variable has been set to true