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

Creates a new disk cartridge device in Backup Exec.

Syntax
New-BEDiskCartridgeDevice [-Name] [<String>] [-DriveLetter] [<String>] [-BlockSizeBytes [<Int32>]] [-BlockAndBufferSizeAutoDetectEnabled [<Boolean>]] [-BufferSizeBytes [<Int32>]] [-BufferedReadsWritesAutoDetectEnabled [<Boolean>]] [-BackupExecServer [<BEBackupExecServer>]] [-PreallocationIncrementBytes [<Int64>]] [-Description [<String>]] [-PreallocationEnabled [<Boolean>]] [-MaximumFileSizeBytes [<Int64>]] [-WhatIf [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [<CommonParameters>]
Description

Creates a new disk cartridge device in Backup Exec.

Parameters

-DriveLetter <String>

Specifies the a system drive letter for the new disk cartridge device.


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


-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


-Description <String>

Specifies the description for the disk cartridge device.


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


-MaximumFileSizeBytes <Int64>

Specifies the maximum file size on the disk storage.


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


-PreallocationEnabled <Boolean>

Enables preallocation of the disk space incrementally.

The valid values are:
$true
$false


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


-PreallocationIncrementBytes <Int64>

Specifies the amount of disk space by which to increase the file size.


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


-BlockAndBufferSizeAutoDetectEnabled <Boolean>

Specifies if Backup Exec automatically detects the preferred settings for the block and buffer size for the disk storage.

The valid values are:
$true
$false


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


-BlockSizeBytes <Int32>

Specifies the size in bytes of blocks of data that can be written to new media.


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


-BufferSizeBytes <Int32>

Specifies the amount of data sent to the disk cartridge on each read or write request.


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


-BufferedReadsWritesAutoDetectEnabled <Boolean>

Specifies that you do not want Backup Exec to automatically detect settings for this disk and enables buffered reads and writes. Buffered reads and writes is the reading and writing of large blocks of data.

The valid values are:
$true
$false


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


-Name <String>

Specifies the name of the new disk cartridge device.


Required true
Position 0
Accepts pipeline input true (ByValue ByPropertyName)
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
System.String

You can pipe a string that contains the name of the Backup Exec disk cartridge device object to create to New-BEDiskCartridgeDevice.

Return Value
BackupExec.Management.CLI.BEDiskCartridgeDevice

New-BEDiskCartridgeDevice returns the disk cartridge device that was created.

Example
C:\PS> New-BEDiskCartridgeDevice -Name "Device 0001" -DriveLetter E:

This command creates a new disk cartridge device named "Device 0001" on drive E of the local Backup Exec server.