WPSecure campaign manager
WPSecure wallpaper deployment has been designed for the side-by-side deployment of wallpaper versions. This feature enables organisations to change a message, introduce a new message or have different messages for varying working groups. The WPSecure campaign manager controls this function.
Please note: WPSecure wallpaper packages will work without the ‘wpsecure.campaigns‘ file. If the ‘wpsecure.campaigns‘ file is not used, the latest version of the locally installed WPSecure wallpaper package will be used.
The WPSecure campaign manager is used to create a ‘wpsecure.campaigns‘ file. Depending on your system architecture, the ‘wpsecure.campaigns‘ file has to be generated and placed in the following location (see image below). ‘wpsecurecc.exe‘ command is used to automate this process. ‘wpsecurecc.exe‘ command is installed with ‘WPsecure campaign manager” (Download here). More information regarding ‘wpsecurecc.exe‘ is available at the bottom of this page.
To edit or create a ‘wpsecure.campaigns‘ file, launch “WPSecure campaign manager” from the start menu.
After you launch the campaign manager, you’ll be presented with an informational screen. Please read it and click the button at the bottom of that window to move to the next page.
Campaign schedules and details are added to the next page.
Click on the “Click to add new campaign” button to add a new campaign. Use the “Click to remove selected items” button to select and remove an item.
Use the “Click to generate a new campaign file” button to save all your campaigns into the ‘wpsecure.campaigns‘ file. You can edit a ‘wpsecure.campaigns‘ file by importing the file using the “Click to import old campaign file” button.
The ‘wpsecure.campaigns‘ file lists campaigns with the following details.
1) Campaign Number (ID): The campaign number is the title or name of the campaign. Each item in the ‘wpsecure.campaigns‘ file will be assigned a campaign number. If WPSecure wallpaper history recording is enabled, the campaign number associated with the WPSecure wallpaper package will also be recorded. The campaign number should be a number between 1 and 99999999.
2) WPSecure Package Version: This is the version number corresponding to the WPSecure wallpaper package. A WPSecure wallpaper package version can be a member of multiple campaigns. The maximum version number is 255.255.65535.65535.
3) Campaign Priority: If a scheduling conflict should arise, the campaign priority (1 -highest priority, 99999999 – lowest priority) will be used to make a decision on which WPSecure wallpaper package version to pick. If multiple WPSecure wallpaper packages have the same campaign priority, then the highest WPSecure wallpaper package version would be picked. The campaign priority should be a number between 1 and 99999999.
4) Campaign group number (ID): This value creates a relationship between the user (employee) and a campaign (campaign number). The WPSecure wallpaper loader automatically picks all the campaigns associated with the current user’s “Campaign group number/ID“. The campaign group ID /number is set both in the ‘wpsecure.campaigns‘ file and in the Current Users Registry, as seen in the image below. Use group policy or PowerShell scripts to deploy this setting to users. This setting can be based on the employee’s department, business unit, group membership, geography, or something else. The campaign group number should be a number between 0 and 99999999.
If the above registry setting is absent/incorrect or does not match the entries in the campaign list within the ‘wpsecure.campaigns‘ file, then the campaign group number/ID is set to 0 (Zero).
If WPSecure wallpaper history recording is enabled, the campaign group number associated with the WPSecure wallpaper package will also be recorded.
5) Campaign Start and End days: As the name indicates, these are the start and end days of the campaign. The start and end days cannot overlap with another campaign with the same WPSecure wallpaper package version and campaign group number.
Automating campaign file deployment:
‘wpsecurecc.exe‘ command is used to automate this process. ‘wpsecurecc.exe‘ command is installed with ‘WPsecure campaign manager” (Download here).
When you generate a ‘WPSecure campaign file’ [See above notes] the following supporting files will be generated.
The process ‘wpsecurecc.exe‘ will copy the ‘wpsecure.campaigns‘ file to the right location under the “Program Files” directory.
Syntax for install
wpsecurecc.exe -version 4.5.67.56
Syntax for uninstall
wpsecurecc.exe -remove
Note: Don’t run the process from an unsecured location like the ‘Downloads‘ folder.
Using the above process, you can deploy the ‘wpsecure.campaigns‘ file using SCCM (Microsoft Endpoint Configuration Manager).
Upload the ‘wpsecurecc.intunewin‘ file to Microsoft Intune as a Win32-application to deploy the Campaign to Cloud connected devices.
Use the registry detection method for both SCCM and Intune
Key path : HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\wpsecure (Key path will be HKEY_LOCAL_MACHINE\SOFTWARE\wpsecure for x86 arch devices)
Value name: wpsecurecampaignversion
Value: Version number used in the install command line above.
Operator: Greater than or equal to.