Backup Exec Management Command Line Interface Help
Grant-BETrust Cmdlet
Synopsis

Establishes a trust between the local Backup Exec server and a remote computer running the Backup Exec agent.

Syntax
Grant-BETrust -AgentServer [<BEAgentServer[]>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

Grant-BETrust [-ComputerName] [<String[]>] [-LogonAccount] [<BELogonAccount>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Description

Establishes a trust between the local Backup Exec server and a remote computer running the Agent for Windows.

Parameters

-AgentServer <BEAgentServer[]>

Specifies one or more agent server objects that you want to establish trust with.


Required true
Position Named
Accepts pipeline input true (ByValue)
Accepts wildcard characters false


-ComputerName <String[]>

Specifies one or more computer names that you want to establish trust with.


Required true
Position 0
Accepts pipeline input true (ByValue ByPropertyName)
Accepts wildcard characters false


-LogonAccount <BELogonAccount>

Specifies the Backup Exec logon account you want to use to log on to the remote computers.


Required true
Position 1
Accepts pipeline input false
Accepts wildcard characters false


-WhatIf <SwitchParameter>

Describes what happens if you execute the command without actually executing the command.


Required false
Position Named
Accepts pipeline input false
Accepts wildcard characters false


-Confirm <SwitchParameter>

Prompts you for confirmation before executing the command.


Required false
Position Named
Accepts pipeline input false
Accepts wildcard characters false


<CommonParameters>

For more information about common parameters, type "Get-Help about_commonparameters".

Input Types
BackupExec.Management.CLI.BEAgentServer

A Backup Exec agent server object can be piped into Grant-BETrust.



System.String

A string can be piped into Grant-BETrust.

Return Values
BackupExec.Management.CLI.BEAgentServer

The Backup Exec agent server object that has been trusted.



System.String

The computer name that has been trusted.

Examples

Example 1

C:\PS> "server01","server02","server03" | Grant-BETrust -LogonAccount "System Logon Account"

This command establishes trust with servers named "server01","server02", and "server03".


Example 2
C:\PS> type servers.txt | Grant-BETrust -LogonAccount "System Logon Account"

This command establishes trust with the names of servers within a text file.