...
Importance: The OrganisationID is crucial for the agent to report data correctly to the RoboShadow portal. Without it, no data will be displayed.
Planning: Plan the organisational structure before deployment. Changing organisations post-deployment is complex due to the DeviceId and public key being tied to the initial OrganisationID.
Deployment Methods
Golden Image Deployment
Recommendation:
Do not install the RoboShadow Agent on the golden image. Deploy the agent post-cloning to avoid issues with OrganisationID, DeviceId, and Public Key.
If Installing on Golden Image:
Follow these steps to clean the image before running sysprep:
Ensure Updater is Installed: Verify that the updater component of RoboShadow is installed.
Delete OrganisationID Registry Key:
HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Rubicon\Agent\OrganisationId
HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Rubicon\Control\OrganisationId
Delete DeviceId Registry Key:
HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Control\DeviceId
Delete Public Key:
C:\ProgramData\RoboShadow\Rubicon\Control\Data\PublicKey
Intune Deployment
o Navigate to https://portal.roboshadow.com/devices and select the organisation you wish to deploy the RoboShadow Agent via InTune, using the organisation drop down menu.
...
o Follow the on-screen setup guide.
Super Super Ops Deployment
To deploy the agent via RMM with an ORGID variable use the following PowerShell script:
...
When you run the script it will ask for the ORGID to be entered
...
MSI-Based Installation
Preparation:
Ensure you have the correct OrganisationID.
Plan your organisational structure in advance.
PowerShell Installation:
Download the installation PowerShell script:
https://raw.githubusercontent.com/roboshadow/RolloutScripts/master/DeployAgent/deploy.ps1
Replace YOUR_ORGANISATION_ID with the organisationID from the correct organisation in the Portal. Note changing this after install is not trivial.
Organisation ID can be found here: https://portal.roboshadow.com/account/organisations
Set $haveSetOrgId to $True
Save and run the PowerShell Script
Golden Image Deployment
Recommendation:
Do not install the RoboShadow Agent on the golden image. Deploy the agent post-cloning to avoid issues with OrganisationID, DeviceId, and Public Key.
If Installing on Golden Image:
Follow these steps to clean the image before running sysprep:
Ensure Updater is Installed: Verify that the updater component of RoboShadow is installed.
Delete OrganisationID Registry Key:
HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Rubicon\Agent\OrganisationId
HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Rubicon\Control\OrganisationId
Delete DeviceId Registry Key:
HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Control\DeviceId
Delete Public Key:
C:\ProgramData\RoboShadow\Rubicon\Control\Data\PublicKey
Summary
By following these guidelines, IT Managers can ensure a successful deployment of the RoboShadow Agent across their Windows environments. Proper planning and adherence to the recommended practices will mitigate common issues and enhance the effectiveness of the rollout.