Shopping Central service command-line arguments

Command line arguments for the Shopping central service are:

  • Help – displays the command-line help for the Shopping Central service. -? can be used instead as a shorthand synonym
  • Relicense – value is a valid the Shopping central license key.

Relicensing Shopping Central from the command-line

If your evaluation license has expired, you can re-license Shopping with a new evaluation license or a new production license. To do this, run the ShoppingCentral executable with a command-line:

ShoppingCentral.exe -relicense=ABCDE-1234-5678-8765-4321

where ABCDE-1234-5678-8765-4321 is your new license key. The command-line may need to be run with elevated rights.

Configuring the Shopping Receiver service

The Shopping Receiver service is configured with the Shopping.Receiver.exe.config file, located by default in:

  • 32-bit systems – Program Files\1E\Shopping\Shopping.Receiver
  • 64-bit systems – Program Files (x86)\1E\Shopping\Shopping.Receiver

The user-configurable settings:

SwitchDefault valueNotes
AdvertFlags

The Configuration Manager legacy package deployment creation setting. This is a decimal value that is directly related to the AdvertFlags value in the SMS_Advertisement Server WMI Class. For example, to set the alternate recommended value:

<add key="AdvertFlags" 
     value="15728672"/>

Default and recommended Configuration Manager legacy package settings has a discussion on default and recommended values for this property.

Refer to the Microsoft Configuration Manager SDK documentation for more details on the values that can be set here.

AdvertFolder

Enables folder customization where Shopping creates its adverts.

Configuration Manager limits the folder name length to 127 characters.
AdvertIdPath

The path where in-progress advert IDs are stored. For example:

<add key="AdvertIdPath" 
     value="C:\TEMP\Shopping"/>
FailureStatusMessageIDs

Any Configuration Manager status IDs returned that match with the IDs provided in this parameter are considered by Shopping to indicate failure. Must be a comma-delimited list of IDs, for example:

<add key="FailureStatusMessageIDs" 
     value="10000,10001,10003,10004,10006,
            10007,10018,10019,10021,10025,
            10026,10030,10031,12101,11170"/>
PolicyRefreshDelay

The Configuration Manager Policy Refresh delay (in seconds), for example:

<add key="PolicyRefreshDelay" 
     value="10"/>
PolicyRefreshInterval

Interval (in seconds) between policy refreshes, for example:

<add key="PolicyRefreshInterval" 
     value="5"/>
PolicyRefreshMode
None

The Shopping Policy Refresh mode, for example:

<add key="PolicyRefreshMode" 
     value="Native"/>


Parameters (values are not case sensitive) are:

  • None – Do not use Policy Refresh
  • Native – Use the native Policy Refresh built into Shopping
  • WakeUp – Use the Policy Refresh functionality provided by WakeUp. Requires that the 1E Agent is installed locally.
RemoteClientFlags

The Configuration Manager Advert remote client flags. This is an integer value that is directly related to the RemoteClientFlags value in the SMS_Advertisement Server WMI Class. For example, to set the alternate recommended value:


<add key="RemoteClientFlags" 
     value="2896"/>
Default and Recommended Advertisement Settings has a discussion on default and recommended values for this property.

Refer to the Microsoft Configuration Manager SDK documentation for more details on the values that can be set here.

RootDeviceCollectionId
SMS00001ID of the root device collection for application model, machine-centric applications. By default, this is the ID for All Systems. Using this value it is possible to configure an alternative machine limiting collection.
RootDeviceCollectionName
All SystemsName of the root device collection for application model, machine-centric applications. By default, this is All Systems. Using this value it is possible to configure an alternative machine limiting collection.
RootUserCollectionId
SMS00004ID of the root user collection for application model, user-centric applications. By default, this is the ID for All Users and User Groups. Using this value it is possible to configure an alternative user limiting collection.
RootUserCollectionName
All Users and User GroupsName of the root user collection for application model, user-centric applications. By default, this is All Users and User Groups. Using this value it is possible to configure an alternative user limiting collection.
ShoppingRequestAttempts

The number of times the Receiver attempts to process a Shopping request, for example:

<add key="ShoppingRequestAttempts" value="3"/>
ShoppingRequestInterval

The interval (in seconds) between checking for unprocessed Shopping requests, for example:

<add key="ShoppingRequestInterval" 
     value="5"/> 
ShoppingWebUrl

The Shopping Web service URL used for querying the API, for example:

<add key="ShoppingWebUrl" 
     value="http://localhost/Shopping.Web"/> 
StatusMessageInterval

The interval, in seconds, between checking Configuration Manager status messages, for example:

<add key="StatusMessageInterval" 
     value="10"/> 
SuccessStatusMessageIDs

Any Configuration Manager status IDs returned that match with the IDs provided in this parameter are considered by Shopping to indicate success.

<add key="SuccessStatusMessageIDs" 
     value="10008,10009,12100,11171"/> 

CommandTimeout


The time out value (in seconds) for the Shopping Receiver when fetching the list of pending AppModel deployments

<add key="CommandTimeout" 
     value="300"/>