New-BEDiskCartridgeDevice Help

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

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.