Share via


Name Element for ParameterDefaults/Parameter (ICF)

Specifies the name of a parameter in the instance configuration file (ICF).

Syntax

<ParameterDefaults>
    <Parameter>
        <Name>

Element Characteristics

Characteristic Description

Data type

string, between 1 and 255 characters in length.

Default value

None.

Occurrence

Required once per Parameter element.

Updates

Can be modified and then applied when updating the instance.

Element Relationships

Relationship Elements

Parent element

Parameter Element for ParameterDefaults (ICF)

Child elements

None.

Remarks

The parameter name must match the name of the parameter to be replaced in the ICF, but without the start and end % characters.

For example, you might need to specify the same directory for several files. Instead of typing the path in each location and having to change it in each location, you can use a parameter. For this example, the format of the parameter to be replaced is %BaseDirPath%; the Name for this parameter is BaseDirPath.

You can override ParameterDefaults values by specifying the parameter name and value when creating or updating the instance.

Example

This example shows how to specify a default parameter value for the parameter named BaseDirPath. Notification Services substitutes "C:\NS" wherever %BaseDirPath% appears in the ICF, unless you specify another value for the parameter on the command line.

<Parameter>
    <Name>BaseDirPath</Name>
    <Value>C:\NS</Value>
</Parameter>

See Also

Reference

Application Definition File Reference

Concepts

Instance Configuration File Reference

Other Resources

Using Parameters in an Instance Configuration File
Updating Instances and Applications

Help and Information

Getting SQL Server 2005 Assistance