SoftwareCentral · Settings

SoftwareCentral settings

The settings under SoftwareCentral on the Settings page: how the interface behaves, the security and variable options, the classic shop, mail, and custom actions. Each one is listed with what it does.

Interface Settings Security Variables Shop Mail Custom Actions

1 Interface Settings

Open Settings, then SoftwareCentral, then Interface Settings. The settings below change how the interfaces look and behave for everyone. Where the checkbox label on screen differs from the name used here, the screen label is given in italics.

SettingWhat it does
Disable Language CultureDisables the language cultures in SoftwareCentral. SoftwareCentral will only be available in English if the language cultures are disabled.
Default languageSets the default language SoftwareCentral is shown in when a user visits SoftwareCentral for the first time. Note that this setting does not work if the language cultures are disabled in the setting above. You have the option to choose Use browser language. This option will set SoftwareCentral to the same language as the browser.
Disable notificationsDisable the notifications popping up in the lower left corner.
Show notification popup in (seconds)The time that the notification popup will show when a new notification comes in.
Notification popup dimensions (width x height)The notification popup dimensions in pixels.
Enable Deployment MonitorEnables the Deployment Monitor in the lower left corner of the interfaces. It will only be available for users with access to the Deployment Manager interface via their security role.
Automatically open the Deployment Monitor when a deployment is addedWhen enabled, all new deployments will open the Deployment Monitor. This requires that the Deployment Monitor is enabled.
Don't allow users to delete computers in the AD
On screen: Hide 'Delete in AD'
This will hide the “Delete in AD” checkbox in the Delete Computer interfaces.
Lock the checkbox so computers are always deleted in the ADThis will force SoftwareCentral to always remove a computer from the AD when it is deleted in SoftwareCentral.
Hide locked variables in Import computerThis will hide variables in Import Computer which are locked in a computer template.
Hide templates in Reinstall Single ComputerThis will hide the computer template drop-down box in the Reinstall Single Computer interface.
Show USMT CheckBox in Reinstall Single ComputerShow a User State Migration checkbox in Reinstall Single Computer. If a user checks this checkbox, a variable will be added to the reinstalled computer called “LAB_USMT” with value “true” indicating to the task sequence that a user state migration should be performed.
Show Rename TextBox in Reinstall Single Computer
On screen: Show Rename
Show a textbox in Reinstall Single Computer where users can enter a new name for the computer about to be reinstalled. Note that renaming or deleting a computer can conflict with a user state migration.
Suggest to rename in Reinstall Single ComputerIf enabled, SoftwareCentral will suggest users to rename computers in Reinstall Single Computer, when selecting a Computer Template with another naming series than the target computer has. Note that this setting only works if “Show Rename TextBox in Reinstall Single Computer” is enabled.
Show Delete Existing Computer checkbox in Reinstall Single ComputerShows a checkbox in Reinstall Single Computer that if checked deletes the computer in the SCCM and AD and then recreates it before the reinstallation. If “Don't allow users to delete computers in the AD” is enabled, the computer will not be deleted in the AD. This setting will not work out-of-the-box with User State Migration and renaming. This setting may result in conflicting records because the deleted computer still exists and may report back to the SCCM. Refresh Machine Policy can not be invoked when the existing computer is deleted from the SCCM, so the reinstallation will not start immediately.
Show Delete in AD checkbox in Reinstall Single ComputerShows a checkbox in Reinstall Single Computer that if checked deletes the computer in the AD before the computer is reinstalled.
Allow Software Lease in Manage Software on a Single ResourceAllow users to lease software in Manage Software on a Single Resource. Leased software will automatically be uninstalled after a given period of time.
Use number of days instead of months when leasing software in Manage Software on a Single ResourceBy default, software is leased in months. This setting will change the period to be in days.
Allow users to see and run available task sequences in Manage Software on a Single ResourceThis setting allows users to see and run task sequences that are deployed as available to the selected device. Users can only see task sequences which are assigned to their security role.
Hide available deployments assigned with query rules in Manage Software on a Single ResourceIf enabled, users won't be able to see software assigned as available via a query rule.
Disable schedule in all interfacesThis will hide the Schedule button in all interfaces, disabling users from scheduling deployments.
Use display names in Client manager instead of user namesWill display the users display names instead of their usernames in the Client Manager.
Remove retired applications from software groupsWhen retiring an application, it will be immediately removed from all Software Groups in SoftwareCentral.
Show user state migration in clone single computerEnable this to show a USMT checkbox in Clone Single Computer. If the user decides to make a user state migration, SoftwareCentral will make a Computer Association between the source and target computer. Note that your task sequence must be able to copy the user state from the source computer.
Only allow 'Clone only software' in clone single computerIf enabled, users will not be able to deselect the clone only software checkbox in Clone single computer.
Deselect existing software in Reinstall Single Computer when a template is appliedEnabled by default. If enabled, already assigned software will be deselected in the assigned software list when a computer template is selected. Software from the computer template will be assigned. If enabled, it is still possible to manually reselect software you do not want to remove.
Hide program names in status message in manage software, if multiple programs is deployed to the same collectionIf enabled, program names of programs deployed to the same collection will not be added to the status message, warning the user that these programs also will be uninstalled.
Dashboard - Workstation collectionReports / graphs for workstations in the Dashboard interface will display all devices in the following collection.
Dashboard - Server collectionReports / graphs for servers in the Dashboard interface will display all devices in the following collection.
Disable “Rename folders and collections” in edit application and edit packageRemoves the option to rename folders and collections in Application Management and Package Management.
Show “Use another computer as template” in import computerShows a combobox in Import Computer where a user can select an existing computer and load all its settings from its machine variables. Note that assigned software outside of Software Groups will not be added to the new computer.
Show advertisement comment in operating system dropdownWill show the comment from the advertisement on mouseover in the OS-drop-down selector.
Only allow cloning of software which are a member of these Package Security Groups (Leave empty to allow all)Only software which is a member of the selected Package Security Groups can be cloned from any of the clone interfaces. To allow cloning of all software, leave this field empty (default behavior).
Only show assigned collections in resource selector collection filter for security rolesIn interfaces where the resource selector can be used, the collection filter in the window will only show assigned collections for security roles.
Default Application TemplateIf you select a default Application Template, it will automatically be selected in the Application Wizard and users will start in the file selection step instead of in the template step.
Show mac addresses in Client ManagerShow devices mac-addresses in the Client Manager interface. Enabling this may impact performance of that interface.
Default selected columns in Export Security RoleSet the columns that will be selected by default when opening the Export Security Roles window.
Default settings in Replace PackageSet the flags that will be pre-selected in the Replace Package interface.

2 Security

Open Settings, then SoftwareCentral, then Security.

SettingWhat it does
Packages must be in a Package Security Group to be visible
On screen: Package Security Group membership required
The default behavior for Package Security Groups is that packages and applications, unassigned to any Package Security Group, will be available to all users. Enabling this setting will hide all packages and applications, unassigned to any Package Security Group, for all users except administrators.
Security roles can't uninstall non assigned packages
On screen: Don't allow uninstall
Enable this so users can’t uninstall software they don’t have permission to install.
Computers can be deleted while importingIf checked, computers are allowed to be deleted during computer imports. E.g.: If a user tries to import a computer that already exists, this setting will allow the user to delete the existing computer, if the users security role allows the user to do so.

3 Variables

Open Settings, then SoftwareCentral, then Variables.

SettingWhat it does
SCCM 2012 Only - Show user agents in user device affinity
On screen: Show user agents in user device affinity
This will show primary devices assigned by the user agents. If disabled, only administrator assigned primary devices will be shown.
Use .Net Time zonesWhen using machine variables there is a time zone variable. This can use a set of predefined time zones from the SoftwareCentral database. The SoftwareCentral time zones are not compatible for some remote regions in Windows 7 and above. Enable this setting to use the new time zone standards.
Enable “OperatedBy” variable in Import ComputerThis will add an additional variable called “OperatedBy” to all computers imported through SoftwareCentral. The value of the variable is the user who imported the computer. Note that HTA’s running in anonymous mode will write the username “service”.
Enable “OperatedBy” variable in Reinstall ComputerThis will add an additional variable called “OperatedBy” to all computers reinstalled through SoftwareCentral. The value of the variable is the user who reinstalled the computer.
Add non-Software Group packages as Machine Variables during operating system deploymentsThis setting only applies to all single Reinstall actions, including: Reinstall Single Computer, Web Services, HTA reinstall, Edit Computer and Clone Single Computer. It does not apply to Reinstall Multiple Computers, Deployment Manager and Clone Multiple Computers.

Adds all packages as machine variables with the Software Group application / package Base Variable Name. The device is then removed from the individual install collections. It is required that all packages and applications can be installed by a task sequence.

Packages and applications will then be installed by the “Install Software Group” step in your task sequences.

It only applies to packages and applications that are deployed with direct membership rules.
Use gaps in Computer Naming Schema
On screen: Use gaps in Computer Naming Schemas
This will allow SoftwareCentral to use computer names that are missing in the sequence when using a Computer Naming Schema.

If you have a naming schema with a prefix “PC” and a 3 digit counter and the following computers: PC001, PC002, PC004.

If you enable this setting, then SoftwareCentral will use “PC003” as the next name. If you do not enable this setting, then SoftwareCentral will use “PC005” as the next name.

When this setting is enabled, SoftwareCentral will use a “reserved name list” in the SoftwareCentral database. So if a user requests a new name, e.g. in Import Computer, but does not import the computer, then the requested name will be reserved for up to 48 hours.

If a user chooses to rename a computer during a reinstallation, the name will be reserved for 90 days or until the computer has been renamed (the Task Sequence has completed).
Web Services throws exception on errorIf enabled, web services will throw a SoapException if an error occurs.

The SoapException will contain details about the error occurred.

Note that if you do not catch the exception in your own code, it may break your application / script.

4 Shop: look and colours

The settings on the Shop tab of SoftwareCentral set how the classic shop looks. The new shop has its own settings: see Shop settings.

SettingWhat it does
Logo path (this can be replaced with your own company logo)The path to the logo used in the shop.

The logo dimensions must be 300 x 100 px.

We recommend that the background color is dark blue: #383D6C H: 166 S: 81 L: 82 R: 56 G: 61 B: 108

For local installation:
The logo must be located within the SoftwareCentral installation folder. The recommended path is \uploads\images\. This will preserve the image during updates of SoftwareCentral.

The path to this folder should be “../Uploads/Images/logo.png”.

Cloud:
The logo must be a URL, e.g.: https://softwarecentral.cloud/pictures/SoftwareCentral.PNG
Shop TitleSets the title of the shop. This is displayed in top of the shop next to your logo.
Shop colorFrom here you can customize the background color and the font color of the header (Shop Title). On screen: Background and Header font color.
Shop menu colorYou can customize the colors of the left side menu in the shop.

1. You can change to logo to your own logo. Change the color of your image to change this fields background color.

2. Use the color picker named “Menu” to change the color of this field. Note that the text in this menu is white, so a very light color for the background will not work particular well.

3. Use the color picker named “Footer menu” to change the color of this field. Note that the color of buttons are white, so a very light color for the background will not work particular well.

The screen also has the colour pickers Basket header background and Basket font color.
Shop buttons colorUse this to change the color of the buttons in the shop. Note that when you change the color of the buttons, we “hover” effect will disappear.
Three rows of colour settings on the Shop tab: Shop color with Background and Header font color, Shop menu color with Menu, Footer menu, Basket header background and Basket font color, and Shop buttons color with Background, Border and Font. Each has a colour picker and a Reset button.
The colour rows on the Shop tab: Shop color, Shop menu color and Shop buttons color. Each colour has its own picker and a Reset button.

5 Shop: features and filters

The settings below decide what shoppers can see, search and filter in the classic shop.

SettingWhat it does
Install applications for usersWhen a user orders an application, the user will be added to the user install collection. If disabled, the device the user is currently using will be added to the device install collection.

Packages and Software Groups will still be installed for the device.
Assign Intune applications to usersWhen a user orders a Intune application, the user will be added to the install group. The user must be the primary user of at least one Intune managed device to see Intune applications.

If disabled, the device the user is currently using will be added to the install group.
Show Intune applications for co-managed devicesIf enabled, co-managed devices will be able to see and order applications from both the Configuration Manager and Intune.
Only show applications with user collectionsThis setting will hide packages and software groups in the shop. It will also hide applications which are not deployed to a user collection.

Custom Shop Items will still be displayed.
Only search in item names
On screen: Only search in name
By default, searches in the shop looks in both package names and descriptions. If this setting “Only search in item names” is enabled, searches will only look in the package names.
Show Alphabetical SearchShow the Alphabetical Search bar below the standard search bar.
Show Sort ByDisplay a combo box in the shop where users can choose between different sorting options. E.g. sort by name or sort by price.
Show Category Dropdown-menuShow the Product Category dropdown menu in the Shop.
Default Category to load items fromOnly the content of this Product Category will be shown in the shop when users load the shop.

The users must actively change the Product Category to see other items.

Leave this combo box empty to display all items the users are allowed to see.
Show Manufacturers Dropdown-menuShow the Manufacturer filter drop-down menu in the shop.
Show Colleague PC Dropdown-menuShow the colleague PC dropdown menu in the Shop.
Limit Colleague PCs to collectionLimit the available devices in the Colleague PC drop-down menu to this collection.

This can for instance be used to sort out servers in this drop-down menu.
Show Clear-Filters buttonShows a button below the filters that clears all filters.
Show 'Only show installed programs'-filterThis will show a button next to the search field in the shop where users can see all software currently installed.
Show installed software lastShow installed software in the bottom of the list.
Show more button in default viewShows the more button which opens a new window with more information about the package. This only applies for the “Default View” and not “Gallery View” and “List View”.
Customize left menuUse this setting to add a custom text to the left menu in the shop. Messages can be written in clear text or html code.

The size of the text field is the same size as the menu should be in the shop.

You can add custom links to other pages or use shop deep links to link to items directly in the shop.

The text is written in the editor opened by the Customize left menu button. The editor is described in Shop texts and settings; see also Create Html Content for information on how to create HTML content.
Show 'My Account'Will show the “My Account” button where users can see their order history.
Open 'My Account' in a windowIf enabled, the My Account page will open in a build-in window in the shop. If disabled, My Account will open in a new browser tab.
Show 'Help'This will show the help button in the shop.
Allow users to change view modeLet users switch between standard, gallery and list view in the shop. If disabled, users can only see the view mode selected in the next setting.
Default view modeThe view mode selected when users open the shop.
Allow users to attach files to ordersIf enabled, users can upload files to their orders in the shop.

Note that a share to store the attachments must be defined.
Share to store attachmentsA share to store order attachments. This share is required if users must be able to upload files. Note that the app-pool user must have access to this share.
Hide 'Available' deployments from the installed software list in the shopHide 'Available' deployments from the installed software list in the shop.
Life cycle translationsPackages in the shop can be in different life cycles. This is the translations of these life cycles. Opened with the Open translations button.
The Show Alphabetical Search setting on the Shop tab: a label on the left and a ticked checkbox labelled Show Alphabetical Search.
The Show Alphabetical Search checkbox on the Shop tab. When it is ticked, the alphabetical bar shows below the standard search bar in the shop.

6 Shop: check out, approval and devices

SettingWhat it does
Install button textChange the text of the install / uninstall / rerun buttons in the shop. This button will open a new window, where you can also see a preview of your new text. Note that the length of the button is fixed, so you cannot make the text to long. The button is Change install button text.
Check out messageSet the check out message that is shown after a user has placed an order in the shop. The size of the window you can edit the check out message in is the same size as the check out box in the shop.

See Create Html Content for information on how to create HTML content. The button is Change check out message.
Show Close Window button on check out pageShow a “Close Window” button on the check out page. Some browsers prevents a web application from closing a window.
Show installation status after check outIf enabled, a window displaying the installation status will popup for the users after they have ordered an application from the shop.

For the best experience, you should also enable the setting “SCCM -> Clients -> Use live data in Manage Software”.
Message on installation status monitorYou can add your own message on the installation monitor. For instance with instructions on expected installation times and how to contact the service desk. The button is Message on installation status monitor.
Warn users if they close the shop with items in their shopping basketPrompt users if they are leaving the shop with items in their shopping basket.
Days before sending reminder to approverThe number of days before an approver will receive a reminder mail about orders pending his or hers approval.
Currency symbolThe currency symbol used in the shop.
Allow approvers to set a temporary approverShow the 'Set Temporary Approver' option in the Approvers View interface.
Active Directory Group for Fixed ApproversThe AD-Group holding the available approvers for the approval flows in Software Administration and Custom Shop Items.
Fixed approver group contains users from multiple domains
On screen: Support users from multiple domains
Uses the global catalog instead of the defined domain controller. This will include users in AD-groups where the user is in another domain than the AD-group, but it will slow down searches.
Get users and their approvers from a CSV file instead of an AD Group
On screen: Get users from CSV file
This setting overrides the Fixed Approver group above. Select approvers from a CSV file instead of an AD group. This functionality is deprecated and should no longer be used.
Computer name lookup (Only use SoftwareCentral Client instead of WMI)Use the SoftwareCentral Client when finding the computer name in the shop. See the guide Use the shop without DNS lookup for more information.
In the shop, let users choose from their primary devicesActivating this setting will override the standard name lookup, including the SoftwareCentral Client, and let users choose which computer they wish to shop for from a list of their primary devices.

If a user only has one primary device assigned, the user will not see the 'choose computer page.'

Enable 'Show user agents in user device affinity', under 'Variables' in the Settings interface, to include primary devices assigned by the user agent, otherwise only administrator assigned devices will be shown.
Always let Mac OS devices choose between their primary devices
On screen: Disable computer name lookup for Mac devices
If enabled, Mac OS based devices will be redirected to the device chooser page. If the users only have one primary device, they will go directly to the shop.

This setting will overrule the “Computer name lookup” setting above for Mac OS devices.
Always send notification mail to approverIf enabled, approvers will get an e-mail each time an order requiring their approval is send.

If disabled, approvers will only get one e-mail while there are orders pending their approval. When disabled, approvers will get a reminder e-mail.
Blacklist Device CollectionDevices in this collection will not have access to the shop.
Allow users to install applications on multiple devices without approval, if they have been approved one time for that applicationIf a user is approved for an application one time, that user will be allowed to install the same application on multiple devices without additional approval.

Note that this setting will overrule approver conditions.
The Install button text row on the Shop tab, with the button Change install button text.
The Install button text row. Click Change install button text to open the editor with a preview.
Installation status monitor The installation status monitor uses lots of system resources. If many users monitor software at the same time it may have an impact on the performance of SoftwareCentral.

7 Mail

SoftwareCentral can send out mails using one of the following three methods, Microsoft Graph, Microsoft 365 or via a SMTP / relay server.

Use the combobox to select how you want to send out mails. Only one method can be active. The choices on screen are Use Microsoft Graph (Intune), Use Microsoft 365 (Office 365) and Use a SMTP server.

Once configured, you can use the “Send test mail” button to verify your settings. Note that this will save all changes made in the settings page.

Microsoft Graph (Intune)

When using Microsoft Graph, you must have configured at least one Intune tenant under General Settings -> Intune Configuration.

Note that sending mails using Microsoft Graph requires additional permissions as described under Intune Permissions.

SettingWhat it does
Send mail from Intune tenantSelect if SoftwareCentral should use the users currently selected Intune tenant for sending mails or if you prefer that all mails are send from a specific Intune tenant.

Mails will always be sent from the Intune service account. That account must have an active mailbox.

Microsoft 365 (Office 365)

When using Microsoft 365, SoftwareCentral connects directly to a Microsoft server and sends mails as the provided Microsoft Account.

SettingWhat it does
Server Host NameThe hostname of the Microsoft 365 server. Typically smtp.office365.com
Server Port (Office 365)The server port is by default 587.
Use SSLUse SSL when connection to Microsoft 365.
Microsoft AccountThe Microsoft account username.
Microsoft account password
On screen: Microsoft Account Password
The Microsoft account password.

SMTP server

You can configure SoftwareCentral to use a local SMTP or relay server.

SettingWhat it does
Server host nameThe fully qualified domain name of the server.
Use Default CredentialsTells whether or not SoftwareCentral needs to authenticate towards the mail server. SoftwareCentral authenticates as the application pool user.
Sender mail address for users with no mail accountThe default sender address.

8 Custom Actions

Custom Actions are scripts which are executed after a specific job in SoftwareCentral, e.g.: after a computer has been imported.

  • A custom action must be enabled before it can be used.
  • A path to the script is required. VBScripts and PowerShell scripts are supported.
  • “Run as” is the user that will be used to execute the script. Users can be added with the Password Manager.
  • The variables which will be parsed on to the script is listed.
Where scripts run Note that scripts are executed on the server hosting SoftwareCentral.

9 Best practice

  • Decide the AD delete rule once. Don't allow users to delete computers in the AD only hides the “Delete in AD” choice; Lock the checkbox so computers are always deleted in the AD forces the AD delete. The hide setting also applies to the AD delete in the Reinstall Single Computer interface, so check both before you change either one.
  • Assign every package to a Package Security Group before you turn on the group rule. With Packages must be in a Package Security Group to be visible on, packages and applications that are not in a group are hidden from everyone except administrators.
  • Check the reserved name rules before you enable gaps in naming. A name requested in Import Computer and not imported stays reserved for up to 48 hours; a name chosen in a reinstall stays reserved for 90 days or until the computer is renamed.
  • Test mail after the other settings are right. Send test mail saves all changes made on the Settings page, not only the mail settings.
  • Keep the approver CSV option off. It is deprecated; use the Active Directory group for fixed approvers.