Additional Installation Options
Microsoft Group Policy - For BridgeChecker Versions 1.09.6 of earlier
BridgeChecker can be deployed using Microsoft Group Policy.
- Create a new Shared folder on the Domain Controller named Software (share with everyone and give everyone read permission).
- Create a folder inside Software named BridgeChecker and put the BridgeCheckerInstaller.msi package there.
- Create a new GPO and link it to the Organizational Unit. Name it BridgeCheckerInstall.
- In the Computers section of the GPO, go to the Software Settings under Policies to get to the Software Installation settings.
- Create a new Package by right-clicking and selecting New-Package.
- Select the .msi file and select any options.
- Run gpupdate /force from the Server (or wait for the Refresh Interval).
- Have your users reboot their client machines.
We have recently moved to an EXE installer. This allows future updates to add and overwrite the previous versions, for quick and easy updating. In the meantime, we are testing and reviewing the deployment steps for Microsoft Group Policy.
Using ProgramData File To Duplicate Configuration
BridgeChecker stores configuration settings in the
c:\ProgramData\AccessAgility\BridgeChecker\settings.mdb file.
For machines with identical hardware, the settings.mdb file can be copied to the folder above to configure multiple machines quickly.
NOTE: The c:\ProgramData folder is hidden by default. Setting can be changed from
Control Panel > Folder Options > View Tab
Using Microsoft Command Prompt
For more information on command line options via Windows Command Prompt, please check out:
https://docs.microsoft.com/en-us/windows/desktop/msi/command-line-options
Below command line parameters are supported. Commands with *** are also support during reinstall/update:
|
Command |
Values |
Purpose |
|
LICENSE_KEY |
text |
*** Sets license key |
|
PASSWORD |
text |
*** Sets the admin password (plain password) |
|
PASSWORD_FILE_PATH |
Example: “\\user-pc\shared\bc\password.t |
Needs to have username/password of system user for which app is being installed to read the file. Replace system folder location with full URL for http(s). Spaces in username should be replaced with "#". |
|
ADD_ICON |
0 |
0 = No wireless on/off desktop shortcut will be added Default = Wireless on/off desktop shortcut will be added |
|
PRIMARY_ENABLE_DISABLE_SECONDARY |
0 |
*** 0 = If wired adapter is connected, wireless adapter is not disabled Default = If wired adapter is connected, wireless adapter is disabled |
|
PRIMARY_DISABLE_ENABLE_SECONDARY |
0, 1, 2 |
*** 0 = If wired adapter is not connected, wireless adapter is not enabled 1 = If wired adapter is not connected, enable wireless adapter 2=If wired adapter is not connected, enable wireless adapter with Desktop On/Off Switch |
|
DISABLE_SECONDARY_ON_BOOTUP_SHUTDOWN |
1, |
*** 1 = Wireless adapter will be disabled on system shutdown and startup Default = Wireless adapter will not be disabled on system shutdown and startup |
|
ADD_BC_STARTMENU_ICON |
0 |
0 = No BridgeChecker icon added to Start Menu Default = BridgeChecker icon added to Start Menu |
|
ENABLE_TERTIARY_ADAPTER |
1 |
*** 1 = Wireless adapter is disabled on system bootup / shutdown 0 = Wireless adapter is not disabled on system bootup / shutdown |
|
RELEASE_IP_ADDRESS |
1 |
*** 1 = Releases IP address associated with adapter before disable the adapter Default = Will not release IP address associated with adapter |
|
NETWORK_PROXY |
http://ipaddress:port/ http://username:password@ipaddress:port/ socks5://ipaddress:port/ |
*** Activate license over the internet that runs through a proxy |
|
USB_ADAPTER_ACTION |
“Whitelist” / “Disable” |
*** Either whitelists all USB adapters, or disables all USB adapters |
|
PRIMARY_ADAPTER |
\"<adapter name from adapter properties>|" |
Allows specific adapters to be added and set as primary during installation. |
|
SECONDARY_ADAPTER |
\"<adapter name from adapter properties>|" |
Allows specific adapters to be added and set as secondary during installation. |
|
WHITELIST_ADAPTERS_FILE_LOCATION |
\\shared-pc\\foldername |
*** Allows for a created list of Whitelisted adapters to be assigned during installation. Text file should use simple text having one adapter per line. |
|
DISABLE_ALL_PRIMARY_IF_ANY_FIRST_PRIMARY_CONNECTED
|
|
*** 1 = Disable all other primaries when any first is connected 0 = No action taken Sub rule for PRIMARY_ENABLE_DISABLE_SECONDARY. Allows having multiple primary and if this rule is set to true the app disable all other primaries when any first is connected. |
| DEBUG_LOGGING_ENABLED
|
1 |
Installation option (supported on the command line as well as on UI). If selected or any value other than 1 meaning Debug logging is disabled by the user. The default value is 1. |
| ENABLE_ALL_ADAPTERS |
1 |
Uninstall option (supported on the command line as well as on UI). If selected or value is 1, all non-whitelisted adapters will be enabled with the uninstall of the app. The default value is 1.
|
| RESET_ADAPTERS |
0, 1 |
This can be used to reset all adapters during the reinstall or update of the app. This will only work during an update (reinstall) and provided during install will be ignored. Valid values 0 or 1. When entered as 1, adapters will be reset. |
NOTE: Please note that adapter name is not same as it is shown in control panel and it’s the actual name of adapter obtained via Right Click → Properties_> Connect Using of adapter
NOTE: If both PASSWORD and PASSWORD_FILE_PATH are provided then PASSWORD_FILE_PATH will always take precedence. Username and password (password of the User on the system) must be used with this parameter. Spaces in the username should be replaced with "#".
NOTE: when UNC paths (local intranet) are used and login permissions are needed then they should be added to the path using comma (same as the password file path).
For example:
WHITELIST_ADAPTERS_FILE_LOCATION="\\shared-pc\\foldername
adapter-names.txt,<username>,<password>"
Sample Commands with Silent Background Installs
The following command will install BridgeChecker and set the password to “12345678”.
BridgeCheckerSetup.exe /s /v"/qn PASSWORD=12345678"
The following command will install BridgeChecker and specify the absolute path of the file in PASSWORD_FILE_PATH that contains the encrypted password.
BridgeCheckerSetup.exe /s /v"/qn PASSWORD_FILE_PATH=c:/<directory>/<subdirectory>/<file.txt>,<myuser>,<mypassword>"
The following command will install BridgeChecker, and set it so that the off-on wireless adapter icon will not be added to the desktop.
BridgeCheckerSetup.exe /s /v"/qn ADD_ICON=0"
The following command will install BridgeChecker, and set it so that the BridgeChecker icon will not be added to the start menu.
BridgeCheckerSetup.exe /s /v"/qn ADD_BC_STARTMENU_ICON=0"
The following command will install BridgeChecker, and set it so that the secondary adapters are automatically disabled if primary adapters are connected.
BridgeCheckerSetup.exe /s /v"/qn PRIMARY_ENABLE_DISABLE_SECONDARY=1"
The following command will install BridgeChecker, and set it so that the secondary adapters will automatically be enabled in the event that the primary adapters are disabled.
BridgeCheckerSetup.exe /s /v"/qn PRIMARY_DISABLE_ENABLE_SECONDARY=1"
The following command will install BridgeChecker, and set it so that secondary adapters will be disabled on boot and shutdown.
BridgeCheckerSetup.exe /s /v"/qn DISABLE_SECONDARY_ON_BOOTUP_SHUTDOWN=1"
The following command includes multiple options.
BridgeCheckerSetup.exe /s /v"/qn ADD_ICON=1 ADD_BC_STARTMENU_ICON=1 LICENSE_KEY=XXXX USB_ADAPTER_ACTION=whitelist DISABLE_ALL_PRIMARY_IF_ANY_FIRST_PRIMARY_CONNECTED=1 PRIMARY_ENABLE_DISABLE_SECONDARY=1 PRIMARY_DISABLE_ENABLE_SECONDARY=2 DISABLE_SECONDARY_ON_BOOTUP_SHUTDOWN=1 RELEASE_IP_ADDRESS=1 ENABLE_TERTIARY_ADAPTER=1 WHITELIST_ADAPTERS_FILE_LOCATION=D:\Projects\BridgeChecker\Documentation\sample-whitelist-adapters.txt"