Get-VBRADDomain

Short Description

Creates an object for connecting to Active Directory domain.

Applies to

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

Syntax

Get-VBRADDomain -ServerName <String> [-Port <Int32>] -Credentials <CCredentials> [-Force] [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRADDomain object for connecting to the Active Directory domain. Veeam Backup & Replication will use this object to access Active Directory objects that you want to add to the scope of a protection group.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
ServerName	Specifies the name for connecting to DC server/domain: DNS name for DC server FQDN or NetBIOS for domain	String	True	Named	True (ByValue, ByProperty Name)
Port	Specifies the port for authenticating with the DC server/Domain. Default: 389.	Int32	False	Named	True (ByProperty Name)
Credentials	Specifies credentials for authenticating with DC server/Domain. Note: for string type, enter a user name in the DNS.DOMAIN.NAME\USERNAME or USERNAME@DNS.DOMAIN.NAME format.	Accepts string (user name) or the CCredentials object. To get this object, run the Get-VBRCredentials cmdlet.	False	Named	True (ByProperty Name)
Force	Defines that the cmdlet will make Veeam Backup & Replication trust the provided TLS and root certificates in the certificate chain without showing warnings in the PowerShell console.	SwitchParameter	False	Named	True (ByPropertyName)

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

Output Object

VBRADDomain

Examples

Example 1. Creating Active Directory Domain Connection Object

This example shows how to create an Active Directory domain connection object using credentials.

$adcreds = Get-Credential

Get-VBRADDomain -Server support.north -Credentials $adcreds

Perform the following steps:

Run the Get-Credential cmdlet. Type the credentials you want to use for authenticating with the DC server or Active Directory domain. Save the result to the $adcreds variable.
Run the Get-VBRADDomain cmdlet. Specify the Server parameter value. Set the $adcreds variable as the Credentials parameter value.

Example 2. Creating Active Directory Domain Connection Object

This command shows how to create an Active Directory domain connection object using credentials in the DNS.DOMAIN.NAME\USERNAME format.

Get-VBRADDomain -Server support.north -Credentials tech.local\jsmith

Related Commands