Install-VBRDiscoveredComputerAgent

Short Description

Installs Veeam Agents on discovered computers.

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

Syntax

Install-VBRDiscoveredComputerAgent -DiscoveredComputer <VBRDiscoveredComputer[]> [-RunAsync]

[-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet installs Veeam Agents on discovered computers.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
DiscoveredComputer	Specifies the array of discovered computers. The cmdlet will install Veeam Agents on these computers. Accepts the `VBRDiscoveredComputer[]` object. To get this object, run the `Get-VBRDiscoveredComputer` cmdlet.	`VBRDiscoveredComputer[]`	True	Named	True (ByPropertyName, ByValue)
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	`SwitchParameter`	False	Named	True (ByPropertyName)
Confirm	Defines whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.	`SwitchParameter`	False	Named	False
WhatIf	Defines whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.	`SwitchParameter`	False	Named	False

<CommonParameters>

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

Output Object

VBRSession

Examples

Install-VBRDiscoveredComputerAgent Example 1. Installing Veeam Agents on Discovered Computers of Selected Protection Group

This example shows how to install Veeam Agents on discovered computers of a selected protection group.

$group = Get-VBRProtectionGroup -Name "East Support"

$computers = Get-VBRDiscoveredComputer -ProtectionGroup $group

Install-VBRDiscoveredComputerAgent -DiscoveredComputer $computers

Perform the following steps:

Run the Get-VBRProtectionGroup cmdlet. Specify the Name parameter value. Save the result to the $group variable.
Run the Get-VBRDiscoveredComputer cmdlet. Set the $group variable as the ProtectionGroup parameter value. Save the result to the $computers variable.
Run the Install-VBRDiscoveredComputerAgent cmdlet. Set the $computers variable as the DiscoveredComputer parameter value.

Install-VBRDiscoveredComputerAgent Example 2. Creating Protection Group and Installing Veeam Agents on Discovered Computers of This Group

This example shows how to create a protection group, manually discover computers of this group and install Veeam Agents on discovered computers of this group.

$computers = @("172.19.51.53", "sup-v8931") | ForEach { New-VBRIndividualComputerCustomCredentials -HostName $_ -Credentials "support\jsmith" }

$compscope = New-VBRIndividualComputerContainer -CustomCredentials $computers

$group = Add-VBRProtectionGroup -Name "Support_East" -Container $compscope

Rescan-VBREntity -Entity $group -Wait

$discovered = Get-VBRDiscoveredComputer -ProtectionGroup $group

Install-VBRDiscoveredComputerAgent -DiscoveredComputer $discovered

Perform the following steps:

Create a scope of computers for a protection group:
- Run the New-VBRIndividualComputerCustomCredentials cmdlet. Use the ForEach statement to apply the same credentials to multiple computers. Save the result to the $computers variable.
- Run the New-VBRIndividualComputerContainer cmdlet. Set the $computers variable as the CustomCredentialsContainer parameter value. Save the result to the $compscope variable.
Run the Add-VBRProtectionGroup cmdlet. Specify the Name parameter value. Set the $compscope variable as the Container parameter value. Save the result to the $group variable.
Run the Rescan-VBREntity cmdlet. Set the $group variable as the Entity parameter value. Provide the Wait parameter.
Run the Get-VBRDiscoveredComputer cmdlet. Set the $group variable as the ProtectionGroup parameter value. Save the result to the $discovered variable.
Run the Install-VBRDiscoveredComputerAgent cmdlet. Set the $discovered variable as the DiscoveredComputer parameter value.