Shell Commands › Utilities › wincfg: Windows Configuration Utility › wincfg: Windows Configuration Utility - Usage

wincfg: Windows Configuration Utility - Usage

Configure a Windows appliance

Syntax

util wincfg name=<app_name:comp_name> admin_pw=<password>
computer_name=<new_name> --newsid [-s] --yes [-y]

Options

name=app_name:comp_name

Name of appliance to configure in the form application_name:component_name

computer_name=name

New computer name of the appliance

admin_pw=-

The password can be set either directly, by supplying the password string on the command line, or typed to a 'shadow-display' password prompt that does not reveal the entered characters. The shadow entry option is selected by using a single '-' character as the password, that is, admin_pw=-. The admin_pw=- option should ALWAYS be used to prevent others from potentially seeing the password by hitting the up arrow key.

--newsid or -s

Change the SID of the appliance, or enable a new SID for the Windows appliance.

--yes or -y

Answer yes to all questions.

Examples

util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST 

Change Computer Name of the Windows appliance to WIN03TST

util wincfg name=tst-windows:main.WIN03S admin_pw=- 

Change Maintainer password for the Windows appliance.

util wincfg name=tst-windows:main.WIN03S --newsid 

Change SID for the Windows appliance

util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST admin_pw=- 

Change Computer Name and Maintainer password for the Windows appliance.

util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST --newsid 

Change Computer Name and SID of the Windows appliance.

util wincfg name=tst-windows:main.WIN03S admin_pw=- --newsid 

Change Maintainer password and SID of the Windows appliance.

util wincfg name=tst-windows:main.WIN03S computer_name=WIN03TST admin_pw=- --newsid 

Change Computer Name and SID of the Windows appliance.

Notes

• wincfg is invoked in the command line shell using util wincfg. Online help is displayed using help util wincfg.
• The option --yes or -y can be added to answer yes to all questions.
• If the application was stopped before the command was executed, then wincfg will ask if the application should be started.
  • If the answer is yes, then the application is started and the required changes are made. After the appliance is restarted for the changes to take effect, the user is asked if the application should be kept running or shut down.
  • If the answer is no, then wincfg performs no action and returns success.
• For the new SID or computer name changes to take effect the appliance needs to be restarted. Once wincfg changes any of these properties, it will ask the user if it wants to restart the appliance.
  • If the user answers no, then it is up to the user the restart the appliance.
  • If the user answers yes, the appliance is restarted.
• If the application is running and the appliance is stopped, the user is asked whether the appliance should be started.
  • If the answer is yes, the appliance is started, the changes are applied and the user is asked whether the appliance should be left running or shut down
  • If the answer is no, wincfg performs no action and returns success.
• If the --newsid is specified, ensure that the appliance contains the NewSID zip archive.

Warning:

• While entering admin_pw, we suggest that you use admin_pw=- option. Entering the password as clear text in the command line poses a security threat.