New-BECloudStorageDevice Help

Synopsis

Creates a new cloud storage device in Backup Exec.

Syntax

New-BECloudStorageDevice [-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 cloud storage device in Backup Exec.

To get a list of registered server types to pass to the ServerType parameter, call Get-BECloudStorageServerType.

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 cloud storage device.

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

-LogicalStorageUnit <String>

Specifies the logical storage unit of the cloud storage device.

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

-LogonAccount <BELogonAccount>

Specifies a Backup Exec logon account for the new cloud storage 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 cloud storage 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 cloud storage device.

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

-Force <SwitchParameter>

Forces the cloud storage 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 cloud storage device object to create to New-BECloudStorageDevice.

Return Value

BackupExec.Management.CLI.BECloudStorageDevice

New-BECloudStorageDevice returns the cloud storage device that was created.

Example

C:\PS> New-BECloudStorageDevice -Name "Device 0001" -HostServer "nirvanix.com" -ServerType "nirvanix" -LogicalStorageUnit "ChildAccount01" -LogonAccount "Logon Account 0001"

This command creates a cloud storage device named "Device 0001" that uses the logical storage type called "ChildAccount01" on the Nirvanix host server called "nirvanix.com" with the logon account "Logon Account 0001".