New-VBRADCustomCredentials - Veeam Backup PowerShell Reference

New-VBRADCustomCredentials -Entity <VBRADEntity> [-Credentials <CCredentials>] [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Entity	Specifies Active Directory objects for which you want to specify custom credentials.	Accepts the VBRADEntity object. To get this object, run the Find-VBRADEntity cmdlet.	True	Named	True (ByValue, ByProperty Name)
Credentials	Specifies custom credentials for authenticating with Active Directory objects in a protection group. If not set, Veeam Backup & Replication will use Master account credentials for authenticating with associated objects. Note: for string type, enter a user name in the "Domain\Username" format.	Accepts string (user name) or the CCredentials object. To get this object, run the Get-VBRCredentials cmdlet.	False	Named	True (ByProperty Name)

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Entity

Specifies Active Directory objects for which you want to specify custom credentials.

Accepts the VBRADEntity object. To get this object, run the Find-VBRADEntity cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

Credentials

Specifies custom credentials for authenticating with Active Directory objects in a protection group.

If not set, Veeam Backup & Replication will use Master account credentials for authenticating with associated objects.

Note: for string type, enter a user name in the "Domain\Username" format.

Accepts string (user name) or the CCredentials object. To get this object, run the Get-VBRCredentials cmdlet.

False

Named

True (ByProperty
Name)

This example shows how to specify custom credentials for authenticating with Active Directory objects.

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

$root = Find-VBRADEntity -Domain $connection

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

$ccreds = Get-Credential

New-VBRADCustomCredentials -Entity $accounts -Credentials $ccreds

Perform the following steps:

Run the Get-VBRADDomain cmdlet. Specify the ServerName and Credentials parameter values. 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 Get-Credential cmdlet. Type the credentials you want to use for authenticating with the Active Directory objects from the Accounts container. Save the result to the $ccreds variable.
Run the New-VBRADCustomCredentials cmdlet. Set the $accounts variable as the Entity parameter value. Set the $ccreds variable as the Credentials parameter value.

This example shows how to specify Master account credentials for the scope of Active Directory objects.

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

$objects = Find-VBRADEntity -Domain $connection -Name Support

New-VBRADCustomCredentials -Entity $objects

Perform the following steps:

Run the Get-VBRADDomain cmdlet. Specify the ServerName and Credentials parameter values. Save the result to the $connection variable.
Run the Find-VBRADEntity cmdlet. Set the $connection variable as the Domain parameter value. Specify the Name parameter value. Save the result to the $objects variable.
Run the New-VBRADCustomCredentials cmdlet. Set the $objects variable as the Entity parameter value.