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

Creates a new OpenStorage device in Backup Exec.

Syntax
New-BEOpenStorageDevice [-Name] [<String>] [-HostServer] [<String>] [-ServerType] [<String>] [-LogicalStorageUnit] [<String>] [-LogonAccount] [<BELogonAccount>] [-DataStreamSizeBytes [<Int32>]] [-SplitDataStreamBytes [<Int64>]] [-AllowedConcurrentOperations [<Int32>]] [-IsStreamHandlerSupportEnabled [<Boolean>]] [-DiskSpaceReserveBytes [<Int64>]] [-BackupExecServer [<BEBackupExecServer>]] [-Description [<String>]] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-Force [<SwitchParameter>]] [<CommonParameters>]
Description

Creates a new OpenStorage device in Backup Exec.

To get a list of registered server types to pass to the ServerType parameter, call Get-BEOpenStorageServerType.

To get a list off logical storage units to pass to the LogicalStorageUnit parameter, call Get-BEOpenStorageLogicalStorageUnit.

Parameters

-BackupExecServer <BEBackupExecServer>

Specifies which Backup Exec server the device should be created on in a CASO environment.


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


-HostServer <String>

Specifies the fully-qualified name of the server on which the device exists.


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


-ServerType <String>

Specifies the type of OpenStorage device.


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


-LogicalStorageUnit <String>

Specifies the logical storage unit of the OpenStorage device.


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


-LogonAccount <BELogonAccount>

Specifies a Backup Exec logon account for the new OpenStorage device. The logon account cannot be the System Logon Account.


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


-Description <String>

Specifies the description for the OpenStorage device.


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


-AllowedConcurrentOperations <Int32>

Sets the maximum allowed concurrent write operations allowed on this device.


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


-SplitDataStreamBytes <Int64>

Specifies the size at which you want Backup Exec to span to a new image.


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


-DataStreamSizeBytes <Int32>

Indicates the size of a single write operation that Backup Exec issues.


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


-IsStreamHandlerSupportEnabled <Boolean>

Specifies if stream handler is used.

The valid values are:
$true
$false


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


-DiskSpaceReserveBytes <Int64>

Specifies the amount of disk space to set aside for applications other than Backup Exec.


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


-Name <String>

Specifies the name of the new OpenStorage device.


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


-Force <SwitchParameter>

Forces the OpenStorage device to be trusted by the Backup Exec server.


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


-WhatIf <SwitchParameter>

Describes what would happen if you executed 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
System.String

You can pipe a string that contains the name of the Backup Exec OpenStorage device object to create to New-BEOpenStorageDevice.

Return Value
BackupExec.Management.CLI.BEOpenStorageDevice

New-BEOpenStorageDevice returns the OpenStorage device that was created.

Example
C:\PS> New-BEOpenStorageDevice -Name "Device 0001" -HostServer "server01" -ServerType "Quantum" -LogicalStorageUnit "lsu1" -LogonAccount "Logon Account 0001"

This command creates an OpenStorage device named "Device 0001" that uses the logical storage type named "lsu1" on the Quantum host server named "server01" with the logon account "Logon Account 0001".

Related Links

Get-BEOpenStorageServerType
Get-BEOpenStorageLogicalStorageUnit