Additional Installation Options

Microsoft Group Policy - For BridgeChecker Versions 1.09.6 of earlier

BridgeChecker can be deployed using Microsoft Group Policy.

  1. Create a new Shared folder on the Domain Controller named Software (share with everyone and give everyone read permission).
  2. Create a folder inside Software named BridgeChecker and put the BridgeCheckerInstaller.msi package there.
  3. Create a new GPO and link it to the Organizational Unit. Name it BridgeCheckerInstall.
  4. In the Computers section of the GPO, go to the Software Settings under Policies to get to the Software Installation settings.
  5. Create a new Package by right-clicking and selecting New-Package.
  6. Select the .msi file and select any options.
  7. Run gpupdate /force from the Server (or wait for the Refresh Interval).
  8. 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
xt,myuser,mypassword”

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
adapter-names.txt

***

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.


Note when uninstalled via Control Panel, app uninstall UI is not shown and since the default value is 1 so adapters will be enabled.

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

BC-13-adapter-name

 

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"