Backup Exec Management Command Line Interface Help
New-BELogonAccount Cmdlet
Synopsis

Creates a new Backup Exec logon account.

Syntax
New-BELogonAccount [[-Name] [<String>]] -Credential [<PSCredential>] [-AccountType {Restricted | Common}] [-Description [<String>]] [-SystemLogonAccount [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

New-BELogonAccount [[-Name] [<String>]] -UserName [<String>] -Password [<SecureString>] [-Description [<String>]] [-AccountType {Restricted | Common}] [-SystemLogonAccount [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [<CommonParameters>]
Description

Creates a new Backup Exec logon account.

Parameters

-Name <String>

Specifies the name of the new logon account.


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


-Credential <PSCredential>

Specifies the credentials of the logon account.


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


-UserName <String>

Specifies the user name of the logon account.


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


-Password <SecureString>

Specifies the password of the logon account.


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


-SystemLogonAccount <SwitchParameter>

Creates the System Logon Account.


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


-Description <String>

Specifies the description for the logon account.


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


-AccountType

Specifies whether this is a common or restricted account.

The valid values are:
Restricted
Common


Required false
Position Named
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 Type
None

This cmdlet does not accept any input.

Return Value
BackupExec.Management.CLI.BELogonAccount

New-BELogonAccount returns the logon account that was created.

Examples

Example 1

C:\PS> $credential = Get-Credential
C:\PS> New-BELogonAccount -Credential $credential

These commands create a new Backup Exec logon account using the credentials received from Get-Credential.


Example 2
C:\PS> $password = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force
C:\PS> New-BELogonAccount -UserName "mydomain\myuser" -Password $password

These commands create a new Backup Exec logon account by specifying a user name and password.