.NET Framework Agent: Programmatically upgrading

Objective

The Contrast .NET Framework agent provides the ability to periodically auto-update. This is enabled by default and can be configured to occur daily or each time the Contrast .NET service is started. Please see the following OpenDocs article for details on configuring the .NET agents auto-update functionality: .NET Configuration.

For customers running the .NET Framework agent in Production environments or with strict change control processes, we recommend disabling auto-update to avoid unexpected changes. This will allow you more control over when new versions of the agent are pushed out.

For environments where auto-update has been disabled, the following steps demonstrate a means of programatically updating the Contrast .NET Framework agent.

Process

Download the following PowerShell script and place this onto the machine where the .NET Framework agent is currently installed: InstallContrast.ps1

Run the PowerShell script with whichever of the following methods best fits your needs:

Run the script directly:

• Locate the script in Windows Explorer
• Right click on the InstallContrast.ps1 file
• Select Run with PowerShell

Run the script in PowerShell

• Open Start
• Search for Windows PowerShell ISE, right-click the top result, and select the Run as administrator option
• Navigate to the directory where the script lives
  PS> cd C:\path\to\script\
• Execute the script:
  PS> .\InstallContrast.ps1

Run the script on a regular schedule

• Open Start
• Search for and open Task Scheduler
• Select Create Basic Task
• Give your task a name, such as "Contrast Upgrade"
• In the Trigger section, specify when you want the task to be run
• In the Action section, select Start a program
• In the Program/script field, enter Powershell.exe (no path should be required)
• In the Add arguments field, enter C:\path\to\script\InstallContrast.ps1
• Review your task and click Finish