---
title: "Invoke-CUAgentUpdate: Update an Agent"
slug: "invoke-cuagentupdate-upgrade-an-agent"
updated: 2026-04-09T14:00:52Z
published: 2026-04-09T14:00:52Z
canonical: "support.controlup.com/invoke-cuagentupdate-upgrade-an-agent"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.controlup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoke-CUAgentUpdate: Update an Agent

The Invoke-CUAgentUpdate cmdlet enables you to **update** ControlUp Agents on local machines to a specific version or the latest available GA version. This PowerShell cmdlet is part of the [ControlUp Automation module](https://www.powershellgallery.com/packages/ControlUp.Automation) and provides a streamlined method for keeping agents current without requiring manual intervention or complex deployment processes.

## Prerequisites

### System Requirements

- **.NET Framework**: Version 4.8 must be installed
- **Existing Agent**: A ControlUp Agent must already be installed on the target machine (this cmdlet updates existing agents, it doesn't perform fresh installations)

### Permissions

- **Administrative Rights**: You must run PowerShell as Administrator to update the agent service
- **Registry Access**: You need read/write access to:
  - `HKLM\SOFTWARE\Smart-X\ControlUp`
  - `HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall`
- **Service Control**: You need permissions to stop and start Windows services

### Network Requirements (for Online Updates)

- **Internet Access**: You need HTTPS access to download agent packages from:
  - `https://downloads.controlup.com` (primary CDN)
- **Proxy Configuration**: If you use a proxy server, you must provide proxy settings through the `-ProxySettings` parameter

### Module Requirements

- **ControlUp.Automation Module**: You must have the ControlUp Automation PowerShell module installed
- **Module Import**: You need to import the module before using the cmdlet:

```
Import-Module ControlUp.Automation
```

## Syntax

```
 Invoke-CUAgentUpdate
      [[-ZipFilePath] <String>]
      [[-Version] <String>]
      [[-ProxySettings] <ProxySettings>]
      [<CommonParameters>]
```

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| **ZipFilePath** | String | No | The absolute path to a local ControlUp Agent ZIP file. If you don't specify this parameter, the cmdlet downloads the agent from ControlUp's CDN. Use this parameter for offline updates or when you have pre-downloaded the agent package. |
| **Version** | String | No | The specific version number you want to update to (e.g., "9.X"). If you don't specify this parameter and no ZipFilePath is provided, the cmdlet downloads and installs the [latest available version](https://downloads.controlup.com). This parameter is ignored when ZipFilePath is specified. |
| **ProxySettings** | ProxySettings | No | The proxy configuration object for environments that require proxy access to reach ControlUp's download servers. You need to create a ProxySettings object with server address, port, and optional credentials. This parameter only applies to online updates. |

### Parameter Notes

- **ZipFilePath** and **Version** work independently:
  - If you provide ZipFilePath, the Version parameter is ignored
  - If you provide only Version, the cmdlet downloads that specific version
  - If you provide neither, the cmdlet downloads the latest version
- **ProxySettings** example:

```
$proxy = New-Object ControlUp.Automation.ProxySettings
$proxy.Server = "proxy.company.com"
$proxy.Port = 8080
```

## Workflow and Examples

### Basic Update Workflow

1. **Open PowerShell as Administrator**
2. Import the ControlUp Automation Module

```
Import-Module ControlUp.Automation
```

1. Run the Update Command

```
 Invoke-CUAgentUpdate
```

1. Verify the Update

```
# Check the result object
$result = Invoke-CUAgentUpdate
    if ($result.Success) {
      Write-Host "Agent updated successfully"
  } else {
      Write-Host "Update failed: $($result.Error)"
  }
```