Entity enrollment via SCCM

This article describes how to create the Entity_Enroll application in Microsoft Configuration Manager (SCCM). The application enrolls a Windows device in myViewBoard Entity by running vBoardInfoGet.exe with your entity name. 

 

Before you begin

Before proceeding, verify that you already have the following requirements set up.

 

  • Configuration Manager console.
    Access to the Microsoft Configuration Manager console, with permissions to create and deploy applications.
  • Target devices.
    Windows devices that are managed by the Configuration Manager client.
  • Entity name.
    The name of your organization in myViewBoard Entity. You will use it in the installation command.
  • Network access.
    Devices must be able to reach https://api.myviewboard.com in the SYSTEM context. If your network uses a proxy, allow this traffic for the SYSTEM account.

 

Prepare the content folder

Create a folder on a network share that the SCCM server can read. For example, \\SCCMServer\Packages\myViewBoard. Note that Configuration Manager will download the entire contents of this folder to each client.

 

Place the following files in the folder:

  • vBoardInfoGet.exe
  • Newtonsoft.Json.dll

 

 

 

Create Application Wizard

First, start Microsoft Configuration Manager to access the Create Application Wizard. 

 

  1. On the Start menu, access the location below to launch the program.

    📂 Microsoft Configuration Manager 
      └─» Configuration Manager Console

Start menu showing Configuration Manager Console under Microsoft Configuration Manager

Access Configuration Manager Console under Microsoft Configuration Manager on the Start menu

 

  1. Wait for the console to launch. On the left-hand menu: 
    1. Click on the Software Library option below. 
    2. Expand the Overview » Application Management folder. 
    3. Click on the Applications option inside the folder. 
    4. Click on the Create Application button on the ribbon.

 

Applications node with Software Library and Create Application highlighted

Click the Create Application button on the top ribbon.

 

  1. This action opens the Create Application Wizard dialog. 
    On the first page:
    1. Select Manually specify the application information.
    2. Click Next.
       
  2. On the General Information page: 
    1. For Name, type Entity_Enroll.
    2. Click Next until you reach the Deployment Types page.
       
  3. On the Deployment Types page, click Add.

 

 


General

Create Application Wizard with Manually specify the application information selected

Select the Manually specify the application information option.

General info

General Information page with Name set to Entity_Enroll

On the General Information page, set Name to the Entity_Enroll value.

Deployment Types

Deployment Types page with the Add button

On the Deployment Types page, click the Add button.


 

Deployment Type Wizard

Once you click Add, the Create Deployment Type Wizard opens. Use this wizard to specify the commands that should run during deployment.

 

  1. On the first General page:
    1. For Type, select Script Installer.
    2. Click Next.
       
  1. On the General Information page:
    1. For Name, specify Script.
    2. Click Next.
       
  1. On the Content page:

    1. For Content location: 
      Specify the network location of the folder that contains the vBoardInfoGet.exe and Newtonsoft.Json.dll files.
       
    2. For Installation program: 
      Replace Your Entity Name with the name of your entity.
      "vBoardInfoGet.exe" ORGANIZATION="Your Entity Name"  
    3. Click Next.
       
  1. On the Detection Method page:
    1. Select Configure rules to detect the presence of this deployment type.
    2. Click Add Clause....

 

 


General

Create Deployment Type Wizard with Script Installer selected

Select Script Installer for Type.

General Info

General Information page with Name set to Script

Set Name to Script.

Content

Content page with the content location and installation program entered

Provide details for the Content location and Installation program fields.

Detection Method

Detection Method page with Configure rules to detect the presence of this deployment type selected

Click Add Clause… on the Detection Method page.


Once you click the Add Clause… button, a new Detection Rule dialog opens where you specify detection rules for this deployment.

 

  1. On this new Detection Rule dialog: 
    1. Configure the detection rule with the values in the table below. 
    2. Click OK to save and close the dialog.
       
Setting Value
Setting type File System
Type File
Path C:\ProgramData\ViewSonic\Sparrow
File name config.json
Detection Rule dialog configured for the config.json file

Configure the Detection Rule dialog.

 

  1. Afterwards, back in the ‘Wizards’ dialogs: 
    1. On the Deployment Type Wizard, click Next until ‘Completion’. 
    2. On the Create Application Wizard, click Next until ‘Completion’. 

 

 

Distribute and deploy

The entity enroll app should now appear on your application list. Use the standard procedures to distribute and deploy your new app. For a quick summary of the process, follow the steps below:

 

  1. To distribute: 
    1. Right-click the new Entity_Enroll app.
    2. Select Distribute Content.
    3. Add your distribution point.
       
  2. To deploy: 
    1. Right-click the new Entity_Enroll app. 
    2. Select Deploy 
    3. Select a device collection that contains only the target devices. 
    4. Set Purpose to Required.
    5. Set the installation deadline to As soon as possible.
       
  3. To check deployment status:
    1. Go to Monitoring » Deployments.
    2. Confirm that the target devices report Success.

 

Follow the onscreen intructions for each procedure until completion. For more detailed information on how to deploy an application to a collection, refer to the official Microsoft documentation here:

 

 

If you plan to deploy myViewBoard 3.0 with Configuration Manager, you can now add the Entity_Enroll app as a dependency of the myViewBoard application to ensure that enrollment happens first. See the myViewBoard 3.0 DISM deployment article.

 

 

Verify on a client

Once complete, verify the deployment on each client.

 

If enrollment succeeds: 

  • Check that the following file exists on the client: 

C:\ProgramData\ViewSonic\Sparrow\config.json
 

If enrollment fails: 

  • The config.json file was not created 
  • Configuration Manager reports error 0x87D00324. 
     

To troubleshoot, check the following log on the client:
C:\ProgramData\ViewSonic\Sparrow\myViewBoardEntity.log 

 

 

 

Need additional help?

Check our other resources — we'll be happy to assist you.