New Variable
============

Category
--------
Variable Commands

Description
-----------

This command allows you to explicitly add a variable if you are not using :doc:`Set Variable <variable>` with the setting **Create Missing Variables** at runtime. Use this command when you want to create a new variable.

Parameters
----------

**Variable Name**
	Name of Variable

**Variable Value**
	The input to be added to the variable

**If Variable Exists**
	Define the action to take if the variable already exists. There are three actions if variable exists

	- *Do Nothing If Variable Exists*
	- *Error If Variable Exists* 
	- *Replace If Variable Exists*	



Returned Value
--------------
	This command return a new variable as indicate in **Variable Name**.

Example Usage
-------------

	Example Location:  
		`BYpass\\Examples\\Variable Commands\\New Variable\\New Variable.xml`

See Also
--------
	- :doc:`Add To Variable <addtovariable>`
	- :doc:`Set Variable <variable>`
	- :doc:`Set Variable Index <setvariableindex>`