New-BEOpenStorageDevice Help

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

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".