A newer version of this documentation is available.

View Latest

config

Name

netid.exe -config - Net iD Client configuration

Synopsis

netid.exe -config [set <arguments>] [get <arguments>] [merge <arguments>]
    [delete <arguments>]

Description

Net iD Client can handle two different types for configuration:

  • Windows INI format

  • Windows Registry

The implementation is not limited to internal configuration. It is also possible to modify by using the options set, get, merge, and delete.

Options and arguments

path

The most important argument is path. The path is either the full path to a file or the full entry to the registry. The system automatically detects what type of value it is.

$ netid.exe -config set -path C:\Temp\aaa.cfg …
$ netid.exe -config merge -read C:\Temp\aaa.cfg -write C:\Temp\aaa.cfg …
$ netid.exe -config delete -path C:\Temp\aaa.cfg …

set

To set or update a value, specify it by using the options section, entry, and value, as they are described in section Configuration.

Example 1. Set or update a value

Update the section AAA and entry aaa with value 112233.

Settings when made in the configuration file.
[AAA]
aaa=112233
Settings when made with CLI.
$ netid.exe -config set -path C:\Temp\aaa.cfg -sections AAA -entry aaa -value 112233
Example 2. Set or update a data value.

To update a data value, specify name and value.

name

Name of data file.

value

Full path to file.

$ netid.exe -config set -path C:\Temp\aaa.cfg -name data.bin -value C:\Temp\data.bin

get

Example 3. Update a data value

To read a data value, specify name and value.

name

Name of data file.

value

Full path to file.

$ netid.exe -config get -path C:\Temp\aaa.cfg -name data.bin -value C:\Temp\data.bin

merge

To merge two different configurations, the path read is the configuration that will be read and all those values will be overwritten for the path write. The result is stored in the write path. You can limit the number of read sections.

$ netid.exe -config merge -read C:\Temp\aaa.cfg -write C:\Temp\aaa.cfg -sections "Language;Install"

delete

To delete you can delete all of a section or an entry within a section.

Example 4. Delete section
$ netid.exe -config delete -path C:\Temp\aaa.cfg -sections AAA
Example 5. Delete entry
$ netid.exe -config delete -path C:\Temp\aaa.cfg -sections AAA -entry aaa