# Synology Active Backup

## Overview

{% hint style="info" %}
**Dev Insight:** This script can also be used to update or reconfigure the Synology Active Backup for business agent.
{% endhint %}

The software applications available for Synology devices can be pretty powerful. One of my favorites, especially for internal IT, is Active Backup for Business (ABB).

<figure><img src="https://3518905989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDwT3zCFJCgmarBv0s7n8%2Fuploads%2F3Yd6PKVyNauGMokjU49i%2Factivebackup_1607392921_1.png?alt=media&#x26;token=e97bab34-8cb7-4027-b269-8500f3e4fff0" alt=""><figcaption></figcaption></figure>

**From their** [**Administrator's Guide**](https://global.synologydownload.com/download/Document/Software/AdminGuide/Package/ActiveBackup/All/enu/Synology_ABB_admin_guide_Windows_PC_PS_enu.pdf)**:**

> ABB centralizes data protection across a variety of IT environments, including virtual machines, physical servers, file servers, and personal computers. Administrators can deploy their preferred protection plan single-handedly through ABB's centralized admin console.&#x20;
>
> ABB also offers a wide range of backup options and restoration tools, as well as a number of optional technical and safety features.

{% embed url="<https://www.synology.com/en-us/dsm/feature/active-backup-business/overview>" fullWidth="false" %}

This script eases the deployment of the backup agent for Windows devices by silently downloading, installing, and configuring the agent on a device.

**Prerequisites:**

1. Setup Active Backup for Business on your Synology NAS.
2. Create a user account to authenticate the agent.
3. Configure your default backup tasks.

***

## Script

{% @github-files/github-code-block url="<https://github.com/wise-io/scripts/blob/main/scripts/InstallSynologyActiveBackup.ps1>" %}

## Examples

```powershell
.\InstallSynologyActiveBackup.ps1 -Address "localhost" -Username "Backups" -Pass "Da ba dee da ba di"
```

This example downloads, installs, and configures the latest version of Synology Active Backup for Business agent.&#x20;

***

## Parameters

`-Address`

**Aliases:** `-Host`, `-Hostname`, `-IP`

Required string paramter that allows passing the hostname or IP address of the Synology device.

`-Username`

**Aliases:** `-User`

Required string parameter that allows you to pass the username required to authenticate with the Synology device.

`-Pass`

**Aliases:** `-Password`

Required string parameter that allows you to pass the password required to authenticate with the Synology device.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://scripts.aaronjstevenson.com/device-management/backups/synology-active-backup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.