Customizing SAConfig.exe

  • Article

SAConfig.exe is the executable file that makes the call to the dynamic-link library (DLL) to change the machine name and administrator password. It is configured through the registry keys described in this topic. The registry tree is HKLM\SOFTWARE\Microsoft\ServerAppliance\SAConfig.

HostnamePrefix

This value is used as a prefix while generating the host name. The WMI parameter that the system reads is appended to this prefix to form the initial host name. The total length of the host name should not exceed 15 characters, including the prefix.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\HostnamePrefix="hpr"

DefaultHostname

This value should be set to the factory preset hostname and is used to determine if the host name has been changed from the factory default.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\DefaultHostname="myhostname"

AdminPasswordPrefix

This value is used as a prefix while generating the administrator password. The WMI parameter that the system reads is appended to this prefix to form the initial administrator password. The total length of the administrator password should not exceed 14 characters, including prefix and suffix.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\AdminPasswordPrefix="apr"

DefaultAdminPassword

This value should be set to the factory preset administrator password. SAConfig will only change the administrator password if it is still set to the factory preset value.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\DefaultAdminPassword="myadminpasswd"

OEMDllName

This value holds the name of the DLL to be used by SAConfig.exe.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\OEMDllName="oemconfigdll.dll"

OEMFunctionName

This value holds the function name exported by the DLL.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\OEMFunctionName="GetUniqueSuffix"

RunOnce

This value is not currently being used.

WMIClassName

This value determines which WMI class will be used in the suffix. The WMI class is expected to be under the root\cimv2 directory.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\WMIClassName="Win32_BIOS"

WMIPropertyName

This value determines which property of the WMI object will be used in the suffix. The WMI object property type is expected to be of type CIM_STRING. You can use wbemdump to find the WMI object property.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\WMIPropertyName="__NAMESPACE"