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 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 Advert 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 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.

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"/>

 

 

 

 

Relicensing Shopping can be performed from the Shopping Central service command-line

Relicensing Shopping via the Central service command-line

Shopping Central service command-line switches