---
title: "Set-VBREPPermission"
description: "Applies user access permissions to backup repositories used by Veeam Agent or Veeam Plug-in operating in the standalone mode."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbreppermission.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Veeam Agent Standalone Mode > Set-VBREPPermission"
dateModified: "2026-08-19"
---

# Set-VBREPPermission

## Short Description
Applies user access permissions to backup repositories used by Veeam Agent or Veeam Plug-in operating in the standalone mode.

## Syntax
```
Set-VBREPPermission -Repository <CBackupRepository> [-Type <VBREPPermissionType>] [-User <String[]>]
 [-EnableEncryption] [-EncryptionKey <VBREncryptionKey>] [-KMSServer <VBRKMSServer>] [-PassThru] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet applies user access permissions to a selected repository that is used as a target by Veeam Agent or Veeam Plug-in operating in the standalone mode.

By default, the backup repositories are configured to have no permissions for writing backups created by Veeam Agent or Veeam Plug-in operating in the standalone mode. To start using a Veeam backup repository as a target, you need to change the access permissions to `Everyone` or `OnlySelectedUsers`.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## 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">EnableEncryption</span></p>
        </td>
        <td>
          <p>Enables the option to encrypt the backups created by Veeam Agent or Veeam Backup for Nutanix AHV.</p><p>Use the <code>EncryptionKey</code> parameter to specify the encryption key.</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">EncryptionKey</span></p>
        </td>
        <td>
          <p>Used to specify the encryption key for the <code>EnableEncryption</code> parameter.</p><p>Accepts the <a href="pscryptokey.md"><code>VBREncryptionKey</code></a> object. To get this object, run the<a href="get-vbrencryptionkey.md"><code> Get-VBREncryptionKey</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBREncryptionKey</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will apply access permissions to a repository without showing warnings in the PowerShell console.</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">KMSServer</span></p>
        </td>
        <td>
          <p>Specifies KMS servers added to the Veeam Backup & Replication console. The cmdlet will decrypt data encrypted by this server.</p><p>Accepts the <a href="vbrkmsserver.md"><code>VBRKMSServer</code></a> object. To get this object, run the <a href="get-vbrkmsserver.md"><code>Get-VBRKMSServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrkmsserver.md"><code>VBRKMSServer</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">PassThru</span></p>
        </td>
        <td>
          <p>Defines that the command returns the output object to the Windows PowerShell console.</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">Repository</span></p>
        </td>
        <td>
          <p>Specifies the repository for which you want to set permissions.</p><p><strong>Note</strong>: You cannot set permissions for Veeam Cloud Connect repositories.</p><p>Accepts string (repository name) or the <code>CBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Type</span></p>
        </td>
        <td>
          <p>Specifies the permission type:</p><ul><li><code>Everyone</code>: everyone has permissions.</li><li><code>NoOne</code>: no one has permissions.</li><li><code>OnlySelectedUsers</code>: the selected users have permissions. Use the User parameter to specify the users.</li></ul><p>Default: the permissions type that is currently set for the selected repository.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBREPPermissionType</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">User</span></p>
        </td>
        <td>
          <p>Used to set users for <code>OnlySelectedUsers</code> option.</p><p>Specifies names of users allowed to use the repository.</p><p>You can specify user names or names of Active Directory groups.</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 [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBREPPermission`](vbreppermission.md)

## Examples

::: example
### Example 1. Granting Repository Permissions to Administrator

This example shows how to grant permission to access the `WinLocal` repository to Administrator.

```
$repository = Get-VBRBackupRepository -Name "WinLocal"
Set-VBREPPermission -Repository $repository -Type OnlySelectedUsers -User "VEEAM\Administrator"
RepositoryId        : 88788f9e-d8f5-4eb4-bc4f-9b3f5403bcec
PermissionType      : OnlySelectedUsers
Users               : {VEEAM\Administrator1, VEEAM\Administrator2}
IsEncryptionEnabled : False
EncryptionKey       :
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save it to the `$repository` variable.
2. Run the `Set-VBREPPermission` cmdlet. Set the `$repository` variable as the `Repository` parameter value. Set the `OnlySelectedUsers` option for the `Type` parameter. Specify the `User` parameter value.

:::

::: example
### Example 2. Enabling Encryption for Repository

This command enables encryption for the `WinLocal` repository.

```
$encryptionkey = Get-VBREncryptionKey -Description "Veeam Administrator"
$repository = Get-VBRBackupRepository -Name "WinLocal"
Set-VBREPPermission -Repository $repository -EnableEncryption -EncryptionKey $encryptionkey
RepositoryId        : 88788f9e-d8f5-4eb4-bc4f-9b3f5403bcec
PermissionType      : OnlySelectedUsers
Users               : {VEEAM\Administrator}
IsEncryptionEnabled : True
EncryptionKey       : ac87709d-b1a9-4c2e-8d55-557f8e49f639
```

Perform the following steps:

1. Run the [`Get-VBREncryptionKey`](get-vbrencryptionkey.md) cmdlet. Specify the `Description` parameter value. Save it to the `$encryptionkey` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save it to the `$repository` variable.
3. Run the `Set-VBREPPermission` cmdlet. Set the `$repository` variable as the `Repository` parameter value. Provide the `EnableEncryption` parameter. Set the `$encryptionkey` variable as the `EncryptionKey` parameter value.

:::

::: example
### Example 3. Granting User Access Permissions to Everyone

This example shows how to grant user access permissions to everyone and enable encryption for the `WinLocal` repository.

```
$encryptionkey = Get-VBREncryptionKey -Description "Veeam Administrator"
$repository = Get-VBRBackupRepository -Name "WinLocal"
Set-VBREPPermission -Repository $repository -Type Everyone -EnableEncryption -EncryptionKey $encryptionkey
RepositoryId        : 88788f9e-d8f5-4eb4-bc4f-9b3f5403bcec
PermissionType      : Everyone
Users               : {VEEAM\Administrator}
IsEncryptionEnabled : True
EncryptionKey       : ac87709d-b1a9-4c2e-8d55-557f8e49f639
```

Perform the following steps:

1. Run the [`Get-VBREncryptionKey`](get-vbrencryptionkey.md) cmdlet. Specify the `Description` parameter value. Save it to the `$encryptionkey` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save it to the `$repository` variable.
3. Run the `Set-VBREPPermission` cmdlet. Specify the following settings:

   - Set the `$repository` variable as the `Repository` parameter value.
   - Set the `Everyone` option for the `Type` parameter.
   - Provide the `EnableEncryption` parameter.
   - Set the `$encryptionkey` variable as the `EncryptionKey` parameter value.

:::

## Related Commands

- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Get-VBREncryptionKey`](get-vbrencryptionkey.md)
- [`Get-VBRKMSServer`](get-vbrkmsserver.md)