This is an archive version of the document. To get the most up-to-date information, see the current version.

New-VBRNASPermissionSet

Short Description

Creates a permission set for instant restore of file share backups that will be used if the file share backup does not contain security information.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides parameter sets that allow you to:

  • Create a permission set that denies access to the published SMB share to everyone except its owner.

New-VBRNASPermissionSet [-RestorePoint] <VBRNASBackupRestorePoint[]> [-Owner] <string> -DenyEveryone  [<CommonParameters>]

  • Create a permission set that allows access to the published SMB share to everyone.

New-VBRNASPermissionSet [-RestorePoint] <VBRNASBackupRestorePoint[]> [-Owner] <string> -AllowEveryone  [<CommonParameters>]

  • Create a permission set that allows access to the published SMB share to the limited number of users. specified in the PermissionScope parameter. This parameter must be specified together with the PermissionScope parameter.

New-VBRNASPermissionSet [-RestorePoint] <VBRNASBackupRestorePoint[]> [-Owner] <string> -AllowSelected   -PermissionScope <string[]>  [<CommonParameters>]

Detailed Description

The cmdlet creates a permission set for instant restore of file share backups that will be used if the file share backup does not contain security information.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

RestorePoint

Specifies an array of restore points. The cmdlet will create a permission set with specific security settings for each of the specified restore points.

Accepts the VBRNASBackupRestorePoint object. To get this object, run the Get-VBRNASBackupRestorePoint cmdlet.

True

0

True (ByValue, ByPropertyName)

Owner

Specifies a name of the account or group in the user name or domain\user name format. The cmdlet will use this parameter if the file share backup does not contain security information.

String

True

1

False

DenyEveryone

Defines that the permission set will deny access to the published SMB share to everyone except its owner.

SwitchParameter

True

Named

False

AllowEveryone

Defines that the permission set will allow access to the published SMB share to everyone.

Note: If the DenyEveryone, AllowSelected, or AllowEveryone parameter is not specified, the cmdlet will use the AllowEveryone parameter by default.

SwitchParameter

True

Named

False

AllowSelected

Defines that the permission set will allow access to the published SMB share to the limited number of users specified in the PermissionScope parameter. This parameter must be specified together with the PermissionScope parameter.

SwitchParameter

True

Named

False

PermissionScope

Specifies an array of users. The cmdlet will provide these users with the access to the published SMB share. This parameter must be specified together with the AllowSelected parameter.

String

True

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns a VBRNASPermissionSet object for each specified restore point. This object defines permission settings that will be applied to instant restore of file share backups.

Examples

New-VBRNASPermissionSetExample 1. Creating Permission Set to Deny Access to SMB Share to Everyone Except Owner

New-VBRNASPermissionSetExample 2. Creating Permission Set to Allow Access to SMB Share to Everyone

New-VBRNASPermissionSetExample 3. Creating Permission Set to Allow Access to SMB Share to Selected Users

Related Commands