New-VBRADContainer

Short Description

Creates a scope of Active Directory objects for a protection group.

Applies to

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

Syntax

New-VBRADContainer -Domain <VBRADDomain> -Entity <VBRADEntity[]> -MasterCredentials <CCredentials> [-ExcludeVMs] [-ExcludeOfflineComputers] [-ExcludeComputers] [-ExcludedEntity <VBRADEntity[]>] [-UseCustomCredentials] [-CustomCredentials <VBRADCustomCredentials[]>] [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRADContainer object. This object contains a scope of Active Directory objects. Use this object to create a protection group with the Add-VBRProtectionGroup cmdlet.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Domain	Specifies the Active Directory domain connection object.	Accepts the VBRADDomain object. To get this object, run the Get-VBRADDomain cmdlet.	True	Named	True (ByValue, ByProperty Name)
Entity	Specifies the array of the Active Directory objects from the same domain. The cmdlet will add these objects to the protection scope. You can add the following types of Active Directory objects: Domain Cluster Organization unit Global group Folder Computer Note: You cannot add Domain Local or Universal groups.	Accepts the VBRADEntity[] object. To get this object, run the Find-VBRADEntity cmdlet.	True	Named	True (ByProperty Name)
ExcludeVMs	Defines that the cmdlet will exclude all VMs from the protection scope. By default this parameter is set to True. If you don't want to exclude VMs from the protection scope, set this parameter to False.	SwitchParameter	False	Named	True (ByProperty Name)
ExcludeOfflineComputers	Defines that the cmdlet will exclude computers that have been offline for over 30 days. By default this parameter is set to True. If you don't want to exclude offline computers from the protection scope, set this parameter to False.	SwitchParameter	False	Named	True (ByProperty Name)
ExcludeComputers	Defines that you want to exclude some Active Directory objects from the protection scope. Use the ExcludeEntity parameter to specify objects you want to exclude from the protection scope.	SwitchParameter	False	Named	True (ByProperty Name)
ExcludedEntity	Specifies Active Directory objects you want to exclude from the protection scope. Note: You cannot exclude Domain Local or Universal groups.	Accepts the VBRADEntity[] object. To get this object, run the Find-VBRADEntity cmdlet.	False	Named	True (ByProperty Name)
MasterCredentials	Specifies Master account credentials for authenticating with all Active Directory objects in a protection scope. For authenticating with Active Directory objects that require different credentials, Veeam Backup & Replication uses custom credentials. If you want to use custom credentials for some Active Directory objects, set the UseCustomCredentials parameter.	Accepts the CCredentials object. To get this object, run the Get-VBRCredentials cmdlet.	True	Named	True (ByProperty Name)
UseCustomCredentials	Defines that you want to use custom credentials for authenticating with some Active Directory objects. To specify custom credentials, use the CustomCredentials parameter.	SwitchParameter	False	Named	True (ByProperty Name)
CustomCredentials	Specifies custom credentials for authenticating with associated Active Directory objects.	Accepts the VBRADCustomCredentials[] object. To create this object, run the New-VBRADCustomCredentials cmdlet.	False	Named	True (ByProperty Name)

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRADContainer

Examples

New-VBRADContainer Example 1. Creating Scope of Active Directory Objects

This example shows how to create a scope of Active Directory objects.

The cmdlet will create a scope with the following settings:

The scope will contain objects of the Active Directory domain container except for the Accounts container.
All computers that have been offline for over 30 days and VMs will be excluded from the scope.
Veeam Backup & Replication will use custom credentials for authenticating with objects from the Servers container.

$connection = Get-VBRADDomain -ServerName support.east -Credentials support\jsmith

$root = Find-VBRADEntity -Domain $connection

$accounts = Find-VBRADEntity -Domain $connection -Root $root -Name "Accounts"

$servers = Find-VBRADEntity -Domain $connection -Root $root -Name "Servers"

$creds = Get-Credential

$custom = New-VBRADCustomCredentials -Entity $servers -Credentials $creds

New-VBRADContainer -Domain $connection -Entity $root -ExcludeComputers -ExcludedEntity $accounts -MasterCredentials support\jsmith -UseCustomCredentials -CustomCredentials $custom

Perform the following steps:

Run the Get-VBRADDomain cmdlet. Specify the ServerName parameter value. Specify the Credentials parameter value. Save the result to the $connection variable.
Run the Find-VBRADEntity cmdlet. Set the $connection variable as the Domain parameter value. Save the result to the $root variable.
Run the Find-VBRADEntity cmdlet. Set the $connection variable as the Domain parameter value. Set the $root variable as the Root parameter value. Specify the Name parameter value. Save the result to the $accounts variable.
Run the Find-VBRADEntity cmdlet. Set the $connection variable as the Domain parameter value. Set the $root variable as the Root parameter value. Specify the Name parameter value. Save the result to the $servers variable.
Run the Get-credential cmdlet. Type the credentials and save the result to the $creds variable.
Run the New-VBRADCustomCredentials cmdlet. Set the $servers variable as the Entity parameter value. Set the $creds variable as the Credentials parameter value. The cmdlet will apply custom credentials to the objects from the Servers container. Save the result to the $custom variable.
Run the New-VBRADContainer cmdlet. Specify the following settings:

Set the $connection variable as the Domain parameter value.
Set the $root variable as the Entity parameter value.
Provide the ExcludeComputers parameter.
Set the $accounts variable as the ExcludedEntity parameter value.
Specify the MasterCredentials parameter value.
Provide the UseCustomCredentials parameter.
Set the $custom variable as the CustomCredentials parameter value.

New-VBRADContainer Example 2. Creating Protection Group with Scope of Active Directory Objects

This example shows how to create a protection group with a scope of Active Directory objects.