---
title: "Add-VBOJob"
description: "This cmdlet creates a backup job that will back up data of your Microsoft 365 and on-premises Microsoft organizations. Before creating a backup job, make sure you are familiar with the following restrictions: Only one backup job can back up an..."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/add-vbojob.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Data Backup > Backup Jobs > Add-VBOJob"
dateModified: "2026-08-21"
---

# Add-VBOJob

## Short Description
Creates a backup job.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllBackupItemsParameterSet (Default)</code></p>

```
Add-VBOJob -Organization <VBOOrganization> -Name <String> -Repository <VBORepository> [-EntireOrganization]
 [-ExcludedItems <VBOBackupItem[]>] [-Description <String>] [-SchedulePolicy <VBOJobSchedulePolicy>] [-RunJob]
 [-SelectedOneDriveFolders <String[]>] [-ExcludedOneDriveFolders <String[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SelectedBackupItemsParameterSet</code></p>

```
Add-VBOJob -Organization <VBOOrganization> -Name <String> -Repository <VBORepository>
 -SelectedItems <VBOBackupItem[]> [-ExcludedItems <VBOBackupItem[]>] [-Description <String>]
 [-SchedulePolicy <VBOJobSchedulePolicy>] [-RunJob] [-SelectedOneDriveFolders <String[]>]
 [-ExcludedOneDriveFolders <String[]>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates a backup job that will back up data of your Microsoft 365 and on-premises Microsoft organizations.

::: note

Before creating a backup job, make sure you are familiar with the following restrictions:

- Only one backup job can back up an entire organization.
- Objects that are already added to the scope of any of your backup jobs will be skipped from the entire organization processing list.
- Several jobs cannot back up the same items if you schedule them to run within the same period. If their schedules overlap, the items will be backed up by the job that starts earlier.

:::

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Description</span></p>
        </td>
        <td>
          <p>Specifies a description of the backup job.</p><p>The default description contains information on the user who added the backup job, date and time when the backup job was added.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">EntireOrganization</span></p>
        </td>
        <td>
          <p>Defines that the job will back up all objects of the organization.</p><p>If you provide this parameter, the cmdlet will add all objects of the organization to the backup job. Otherwise, you must select objects that you want to back up.</p><p><strong>Note</strong>: The backup job will not back up objects, processed by other backup jobs.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ExcludedItems</span></p>
        </td>
        <td>
          <p>Specifies an array of objects that the job will not back up.</p><p><strong>Note</strong>: You cannot exclude objects that have been specified for the <code>SelectedItems</code> parameter.</p><p>Accepts the <a href="vbobackupitem.md"><code>VBOBackupItem</code></a><code>[]</code> object.</p><ul><li>To get this object, run the <a href="get-vbobackupitem.md"><code>Get-VBOBackupItem</code></a> cmdlet.</li><li>To create this object, run the <a href="new-vbobackupitem.md"><code>New-VBOBackupItem</code></a> cmdlet.</li></ul>
        </td>
        <td style="width:10%;">
          <p><a href="vbobackupitem.md"><code>VBOBackupItem[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ExcludedOneDriveFolders</span></p>
        </td>
        <td>
          <p>Specifies an array of OneDrive folders that a backup job will not back up.</p>
        </td>
        <td style="width:10%;">
          <p><code>String[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Name</span></p>
        </td>
        <td>
          <p>Specifies a name of the backup job. The cmdlet will create a backup job with this name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Organization</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft organization. The backup job will back up objects of this organization.</p><p>Accepts the <a href="vboorganization.md"><code>VBOOrganization</code></a> object.</p><p>To get this object, run the <a href="get-vboorganization.md"><code>Get-VBOOrganization</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboorganization.md"><code>VBOOrganization</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Repository</span></p>
        </td>
        <td>
          <p>Specifies a backup repository. Veeam Backup for Microsoft 365 will store backups in this repository.</p><p><strong>Note</strong>: If you want to create a backup copy job for this backup job, you must specify an object storage repository.</p><p>Accepts the <a href="vborepository.md"><code>VBORepository</code></a> object.</p><p>To get this object, run the <a href="get-vborepository.md"><code>Get-VBORepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vborepository.md"><code>VBORepository</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RunJob</span></p>
        </td>
        <td>
          <p>Defines that a backup job will run right after you create it.</p><p>If you provide this parameter, the job will start after you run the script. Otherwise, the cmdlet will create a backup job in the stopped status.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SchedulePolicy</span></p>
        </td>
        <td>
          <p>Specifies schedule settings for a backup job.</p><p>Accepts the <a href="vbojobschedulepolicy.md"><code>VBOJobSchedulePolicy</code></a> object.</p><p>To create this object, run the <a href="new-vbojobschedulepolicy.md"><code>New-VBOJobSchedulePolicy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbojobschedulepolicy.md"><code>VBOJobSchedulePolicy</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SelectedItems</span></p>
        </td>
        <td>
          <p>Specifies an array of objects that the job will back up.</p><p>Accepts the <a href="vbobackupitem.md"><code>VBOBackupItem</code></a><code>[]</code> object.</p><ul><li>To get this object, run the <a href="get-vbobackupitem.md"><code>Get-VBOBackupItem</code></a> cmdlet.</li><li>To create this object, run the <a href="new-vbobackupitem.md"><code>New-VBOBackupItem</code></a> cmdlet.</li></ul>
        </td>
        <td style="width:10%;">
          <p><a href="vbobackupitem.md"><code>VBOBackupItem[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SelectedOneDriveFolders</span></p>
        </td>
        <td>
          <p>Specifies an array of OneDrive folders that the job will back up.</p>
        </td>
        <td style="width:10%;">
          <p><code>String[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOJob`](vbojob.md) object that contains settings for a backup job.

## Examples

::: example
### Example 1: Creating Job to Back Up Selected Items

This example shows how to create a job that will back up selected backup items of an organization except for the exclusions.

```
$org = Get-VBOOrganization -Name "ABC Company"
$repository = Get-VBORepository -Name "ABC Backup Files"
$excludedUser = Get-VBOOrganizationUser -Organization $org -Name "UserAlpha"
$excludedItem = New-VBOBackupItem -Mailbox -User $excludedUser
$item1 = New-VBOBackupItem -Organization $org -Mailbox
Add-VBOJob -Organization $org -Repository $repository -Name "ABC Backup" -SelectedItems $item1 -ExcludedItems $excludedItem -RunJob 
Organization       Repository         Name               IsEnabled LastStatus   Description
------------       ----------         ----               --------- ----------   -----------
ABC Company        ABC Backup Files   ABC Backup         True      Stopped
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](get-vboorganization.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$org` variable.
2. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
3. Run the [`Get-VBOOrganizationUser`](get-vboorganizationuser.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `Name` parameter value. Save the result to the `$excludedUser` variable.
4. Run the [`New-VBOBackupItem`](new-vbobackupitem.md) cmdlet. Provide the `Mailbox` parameter. Set the `$excludedUser` variable as the `User` parameter value. Save the result to the `$excludedItem` variable.
5. Run the [`New-VBOBackupItem`](new-vbobackupitem.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Provide the `Mailbox` parameter. Save the result to the `$item1` variable.
6. Run the `Add-VBOJob` cmdlet. Specify the following settings:

   - Set the `$org` variable as the `Organization` parameter value.
   - Set the `$repository` variable as the `Repository` parameter value.
   - Specify the `Name` parameter value.
   - Set the `$item1` variable as the `SelectedItems` parameter value.
   - Set the `$excludedItem` variable as the `ExcludedItems` parameter value.
   - Provide the `RunJob` parameter.

The cmdlet output will contain the following details on the backup job: `Organization`, `Repository`, `Name`, `IsEnabled`, `LastStatus` and `Description`.

:::

::: example
### Example 2: Creating Job to Back Up Entire Organization

This example shows how to create a job that will back up the entire organization. Items backed up by other jobs will not be included.

```
$org = Get-VBOOrganization -Name "ABC Company"
$repository = Get-VBORepository -Name "ABC Backup Files"
Add-VBOJob -Name "ABC Backup" -Organization $org -Repository $repository -Description "New Organization" -EntireOrganization -RunJob 
Organization       Repository         Name               IsEnabled LastStatus   Description
------------       ----------         ----               --------- ----------   -----------
ABC Company        ABC Backup Files   ABC Backup           True      Stopped      New Organization
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](get-vboorganization.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$org` variable.
2. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
3. Run the `Add-VBOJob` cmdlet. Specify the following settings:

   - Set the `$org` variable as the `Organization` parameter value.
   - Set the `$repository` variable as the `Repository` parameter value.
   - Specify the `Name` parameter value.
   - Provide the `EntireOrganization` parameter.
   - Provide the `RunJob` parameter.

The cmdlet output will contain the following details on the backup job: `Organization`, `Repository`, `Name`, `IsEnabled`, `LastStatus` and `Description`.

:::

## Related Commands

- [`Get-VBOOrganization`](get-vboorganization.md)
- [`Get-VBORepository`](get-vborepository.md)
- [`Get-VBOOrganizationUser`](get-vboorganizationuser.md)
- [`New-VBOJobSchedulePolicy`](new-vbojobschedulepolicy.md)
- [`New-VBOBackupItem`](new-vbobackupitem.md)
- [`Get-VBOBackupItem`](get-vbobackupitem.md)