Backup Exec Management Command Line Interface Help
Set-BEDiskStorageDevice Cmdlet
Synopsis

Sets the properties for a disk storage device in Backup Exec.

Syntax
Set-BEDiskStorageDevice -InputObject [<BEDiskStorageDevice[]>] [[-BackupExecServer] [<BEBackupExecServer>]] [-BufferSizeBytes [<Int32>]] [-DiskSpaceReserveBytes [<Int64>]] [-BlockSizeBytes [<Int32>]] [-VirtualWriteProtectionEnabled [<Boolean>]] [-BufferedReadsWritesAutoDetectEnabled [<Boolean>]] [-BlockAndBufferSizeAutoDetectEnabled [<Boolean>]] [-AllowedConcurrentWriteOperations [<UInt32>]] [-Disabled [<Boolean>]] [-Paused [<Boolean>]] [-PreallocationIncrementBytes [<Int64>]] [-Description [<String>]] [-LowDiskSpaceInformationThresholdPercent [<Int32>]] [-MaximumFileSizeBytes [<Int64>]] [-PreallocationEnabled [<Boolean>]] [-LowDiskSpaceWarningThresholdPercent [<Int32>]] [-LowDiskSpaceCriticalThresholdPercent [<Int32>]] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Description

Sets the properties for a disk storage device in Backup Exec.

Parameters

-BackupExecServer <BEBackupExecServer>

Specifies which Backup Exec server the device is attached to in a CASO environment.


Required false
Position 1
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


-Disabled <Boolean>

Specifies if the disk storage device is disabled.

The valid values are:
$true
$false


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


-Paused <Boolean>

Specifies if the disk storage device is paused.

The valid values are:
$true
$false


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 that you want this disk storage to allow buffered reads and writes, which 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


-InputObject <BEDiskStorageDevice[]>

Specifies one or more disk storage device objects. Enter a variable that contains the objects, or type a command or expression that gets the objects.


Required true
Position Named
Accepts pipeline input true (ByValue)
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
BackupExec.Management.CLI.BEDiskStorageDevice

You can pipe a Backup Exec disk storage device object to Set-BEDiskStorageDevice.

Return Value
BackupExec.Management.CLI.BEDiskStorageDevice

Set-BEDiskStorageDevice returns an object that represents the changed disk storage device.

Example
C:\PS> Get-BEDiskStorageDevice "Device 0001" | Set-BEDiskStorageDevice -Paused $true

These commands pause the disk storage device named "Device 0001".

Related Link

Get-BEDiskStorageDevice