Deploy Agent Smith with ImmyBot
Last updated
Was this helpful?
Last updated
Was this helpful?
is an extremely powerful DSC platform that utilizes integrated agents to spawn an 'ephemeral' agent. This agent is then capable of running scripts such as the ones provided in this directory while being fueled by Immy's amazing PS Functions.
One important thing to know if you've never used Immy, is that Invoke-ImmyCommand
is essentially the same as PSRemote
's Invoke-Command
.
Create the object in Immy
Immy uses software objects to interpret an application that should be deployed and how to do so.
The scripts should be entered in the corresponding blank script fields
The PowerShell scripts handle:
Detection of the agent
Installation of the agent
Uninstallation of the agent
Dynamically acquiring the latest version of the agent
Comparing the existing version vs. the latest version and applying the desired state.
Create and assign a to the software object.
Configuration tasks can run post-install/update/detection scripts typically intended for ensuring running compliance with your configured settings.
Configuration tasks also store parameters for the software object. This allows for using variables in every other script for the software object, even without scripts being set on the task.
Create and define a
Deployments are where the magic happens- this is where you tell Immy where and if you want your software present.
Select Agent Smith
for the software in question, fill in the parameters
Using Agent Smith for Immy script execution (coming soon)
To set up a software in Immy for Agent Smith, start in the left menu, then Library > Software > New
.
This will bring you to a setup page that asks for an installer. Go ahead and indicate none
here.
Next, it will ask for a software to add the version to. Select Add version to new software
.
After selecting new software
, you should be on the actual setup page now. Enter a name, logo, and description for your agent
Begin loading the PowerShell scripts into each corresponding field.
The names of the scripts I provide in this directory indicate where they should be used on this page.
The image below should also serve as a handy guide:
You will also need to set up a Configuration Task
in order to pass parameters into the script.
The way Immy handles this is by loading said parameters into a Configuration Task
, then filling in your parameters:
Once parameters are all set, set Scripts
to Use separate scripts
and disable the Test
, Get
, and Set
scripts, as we do not need to do any post-install configuration.
Once the rest is completed, all you need to do is deploy!
Fill in all parameters, select your targets, and you're done! If you have any troubles, the people in the channel in the has a ton of brilliant people willing to help :)