New-BEDiskStorageDevice Help

Synopsis

Creates a new disk storage device in Backup Exec.

Syntax

New-BEDiskStorageDevice [-Name] [<String>] [-DriveLetter] [<String>] [-DiskSpaceReserveBytes [<Int64>]] [-VirtualWriteProtectionEnabled [<Boolean>]] [-BlockSizeBytes [<Int32>]] [-BufferSizeBytes [<Int32>]] [-BufferedReadsWritesAutoDetectEnabled [<Boolean>]] [-BlockAndBufferSizeAutoDetectEnabled [<Boolean>]] [-AllowedConcurrentWriteOperations [<UInt32>]] [-Description [<String>]] [-LowDiskSpaceInformationThresholdPercent [<Int32>]] [-PreallocationIncrementBytes [<Int64>]] [-BackupExecServer [<BEBackupExecServer>]] [-MaximumFileSizeBytes [<Int64>]] [-PreallocationEnabled [<Boolean>]] [-LowDiskSpaceWarningThresholdPercent [<Int32>]] [-LowDiskSpaceCriticalThresholdPercent [<Int32>]] [-WhatIf [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [<CommonParameters>]

New-BEDiskStorageDevice [-Name] [<String>] [-UncPath] [<String>] [-DiskSpaceReserveBytes [<Int64>]] [-VirtualWriteProtectionEnabled [<Boolean>]] [-BlockSizeBytes [<Int32>]] [-BufferSizeBytes [<Int32>]] [-BufferedReadsWritesAutoDetectEnabled [<Boolean>]] [-BlockAndBufferSizeAutoDetectEnabled [<Boolean>]] [-AllowedConcurrentWriteOperations [<UInt32>]] [-Description [<String>]] [-LowDiskSpaceInformationThresholdPercent [<Int32>]] [-PreallocationIncrementBytes [<Int64>]] [-BackupExecServer [<BEBackupExecServer>]] [-MaximumFileSizeBytes [<Int64>]] [-PreallocationEnabled [<Boolean>]] [-LowDiskSpaceWarningThresholdPercent [<Int32>]] [-LowDiskSpaceCriticalThresholdPercent [<Int32>]] [-WhatIf [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [<CommonParameters>]

Description

Creates a new disk storage device in Backup Exec.

Parameters

-DriveLetter <String>

Specifies the a system drive letter of the new disk device.

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

-UncPath <String>

Specifies the UNC path of the new disk device.

Required	true
Position	1
Accepts pipeline input	false
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 storage device.

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

-LowDiskSpaceInformationThresholdPercent <Int32>

Specifies the first threshold limit for initial low disk space alert.

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

-LowDiskSpaceWarningThresholdPercent <Int32>

Specifies the second threshold limit for second low disk space alert.

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

-LowDiskSpaceCriticalThresholdPercent <Int32>

Specifies the third and final threshold limit for initial low disk space alert, you are prompted immediately to create more disk space.

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 proallocation to occur.

The valid values are:
$true
$false

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

-PreallocationIncrementBytes <Int64>

Specifies the size of preallocating space to increment at a time.

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

-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

-VirtualWriteProtectionEnabled <Boolean>

Enables virtual write protection.

The valid values are:
$true
$false

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

-AllowedConcurrentWriteOperations <UInt32>

Allows concurrent write operations to disk.

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 storage 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 storage device object to create to New-BEDiskStorageDevice.

Return Value

BackupExec.Management.CLI.BEDiskStorageDevice

New-BEDiskStorageDevice returns the disk storage device that was created.

Example

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

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