NAME

Add-DcsVirtualDisk

SYNOPSIS

Creates a virtual disk.

SYNTAX

Add-DcsVirtualDisk   [ -Name <String> ]   -Size <DataSize>   [ -SectorSize <DataSize> ]   [ -Count <Int32> ]   [ -Server <String> ]   -Pool <String>   [ -AssignToCurrentUser]  [-CyberResiliencyRatingEnabled <Boolean>] [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Add-DcsVirtualDisk   [ -Name <String> ]   -Size <DataSize>   [ -SectorSize <DataSize> ]   -LogicalDisk <Object>   [ -AssignToCurrentUser] [-EncryptionEnabled] [-DeduplicationEnabled <Boolean>] [-CompressionEnabled <Boolean>] [-OptimizeStaleOnly <Boolean>] [-StaleDataWeight <UInt32>]  [-CyberResiliencyRatingEnabled <Boolean>] [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Add-DcsVirtualDisk   [ -Name <String> ]   -Size <DataSize>   [ -SectorSize <DataSize> ]   [ -Count <Int32> ]   [ -FirstServer <String> ]   [ -SecondServer <String> ]   [ -FirstPool <String> ]   [ -SecondPool <String> ]   [ -BackupServer <String> ]  [ -BackupPool <String> ] [ -FirstPassThroughDisk <String> ]   [ -SecondPassThroughDisk <String> ]   [ -EnableRedundancy]   [ -AssignToCurrentUser] [-EncryptionEnabled] [-DeduplicationEnabled <Boolean>] [-CompressionEnabled <Boolean>] [-OptimizeStaleOnly <Boolean>] [-StaleDataWeight<UInt32>]  [-CyberResiliencyRatingEnabled <Boolean>] [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Add-DcsVirtualDisk   [ -Name <String> ]   -Size <DataSize>   [ -SectorSize <DataSize> ]   -FirstLogicalDisk <Object>   -SecondLogicalDisk <Object> [ -BackupLogicalDisk <Object>]  [ -AssignToCurrentUser]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Add-DcsVirtualDisk   [ -Name <String> ]   -Size <DataSize>   [ -SectorSize <DataSize> ]   [ -Count <Int32> ]   [ -FirstServer <String> ]   [ -SecondServer <String> ]   [ -SharedPool <String> ]   [ -ApproveSMPA]   [ -SharedDisk <String> ]   [ -EnableRedundancy]   [ -AssignToCurrentUser] [-EncryptionEnabled] [-DeduplicationEnabled <Boolean>] [-CompressionEnabled <Boolean>] [-OptimizeStaleOnly <Boolean>] [-StaleDataWeight <UInt32>] [-CyberResiliencyRatingEnabled <Boolean>] [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

Add-DcsVirtualDisk   [ -Name <String> ]   -PassThroughDisk <String>   [ -Server <String> ]   [ -AssignToCurrentUser] [-EncryptionEnabled] [-DeduplicationEnabled <Boolean>] [-CompressionEnabled <Boolean>] [-OptimizeStaleOnly <Boolean>] [-StaleDataWeight <UInt32>] [-CyberResiliencyRatingEnabled <Boolean>] [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

DESCRIPTION

Creates a virtual disk. Multiple virtual disks can be created if all storage sources are from pools. All virtual disks will be created using the same parameters. If using a pass-through or logical disk as a storage source, then one virtual disk can be created. Virtual disks can be single, dual, or mirrored. After virtual disks are created, virtual disks can be served to clients, see Serve-DcsVirtualDisk. Properties can be customized, see Set-DcsVirtualDiskProperties, Set-DcsVirtualDiskSize.

PARAMETERS

-Name<String>

Name of the virtual disk to create. If specified and multiple virtual disks will be created, the virtual disks created will begin with the designated name and have a number appended to the end of the name. Subsequent names will have the number incremented.If not specified a default name will be assigned. The default name will consist of "Virtual disk" with the next available number assigned. For instance, if no other virtual disks have default names assigned, the virtual disk will be named "Virtual disk 1". If creating multiple virtual disks, subsequent virtual disks created will be named "virtual disk 2" and so on.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Size<DataSize>

The size of the virtual disk to create. Valid values consist of the number followed by the unit of measurement (MiB, GiB, TiB). Decimals may be used. For example, "100GiB", "1.5TiB", and "500000MiB" are valid sizes. Size can range from a minimum of 1GiB to a maximum of 1024TiB.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-SectorSize<DataSize>

The sector size of the virtual disk. Valid values are "512", "512B", "4096", or "4KiB". If the unit is not included, it is assumed to represent the number of bytes in the sector. If this parameter is not specified, the default of 512 bytes will be used.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Count<Int32>

The number of virtual disks to create when storage sources are from pools. If not specified, one virtual disk will be created. Multiple virtual disks will be created with the same specifications indicated in the Cmdlet parameters. Multiple virtual disks cannot be created using pass-through disks or logical disks.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Server<String>

Computer name or ID of the server used to create a single virtual disk. The computer name must be unique or the name must be fully qualified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Pool<String>

Name or ID of the disk pool to use as the storage source of a single virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified. If the pool is not specified, the pool with the largest amount of available space on the specified server will be used.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-AssignToCurrentUser

Use this parameter to assign exclusive ownership to the user account currently logged in. This restricts all operations on the virtual disks being created to only the authenticated user for the current PowerShell session.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-EncryptionEnabled

Use this parameter to enable encryption on the virtual disk.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-DeduplicationEnabled [<Boolean>]

Use this parameter to enable Inline Deduplication on the virtual disk.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-CompressionEnabled [<Boolean>]

Use this parameter to enable Inline Compression on the virtual disk.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-OptimizeStaleOnly [<Boolean>]

Use this parameter to enable optimization only for stale data of the virtual disk. This option can be enabled only when Inline Compression, Inline Deduplication, or both are enabled.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-StaleDataWeight <UInt32>

Use this parameter to specify the Optimization Policy applied to stale data of the virtual disk. Valid values include "32", "64", and "96". The input is rounded to these valid values. The default value is "64" which specifies the Normal Optimization Policy. Similarly, "32" specifies Lazy and "96" specifies Aggressive Optimization Policy.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-CyberResiliencyRatingEnabled [<Boolean>]

Use this parameter to specify whether to enable or disable Cyber Resiliency Rating for the virtual disk. Specify $true to enable or $false to disable.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-Connection<String>

Alias of the connection to the server group. If not specified, the default connection will be used.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PipelineVariable<String>

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LogicalDisk<Object>

LogicalDiskData object or ID of the logical disk used as the storage source of a single virtual disk. The LogicalDiskData object can be retrieved by invoking Get-DcsLogicalDisk.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-FirstServer<String>

Computer name or ID of the server with the first storage source (FirstPassThroughDisk or FirstDiskPool parameters) used in a mirrored or dual virtual disk. The computer name must be unique or the name must be fully qualified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-SecondServer<String>

Computer name or ID of the server with the second storage source (SecondPassThroughDisk or SecondDiskPool parameters) used in a mirrored or dual virtual disk. The computer name must be unique or the name must be fully qualified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-FirstPool<String>

Name or ID of the disk pool to use as the first storage source of a mirrored virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-SecondPool<String>

Name or ID of the disk pool to use as the second storage source of a mirrored virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters:

 

-BackupServer<String>

The computer name or ID of the server that contains the backup storage source (specified by the BackDiskPool parameter) used in a mirrored virtual disk. The computer name must be unique, or it must be fully qualified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-BackupPool<String>

Name or ID of the disk pool to use as the backup storage source for a mirrored virtual disk. To resolve by name, the name must be unique to the server group, or the server must be specified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-FirstPassThroughDisk<String>

The disk name or ID of the pass-through disk used as the first storage source of a mirrored virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified. Data on the specified first pass-through disk will be mirrored to the second storage source (SecondDiskPool or SecondPassThroughDisk parameters).

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-SecondPassThroughDisk<String>

The disk name or ID of the pass-through disk used as the second storage source of a mirrored virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified. IMPORTANT: The data on the specified second pass-through disk will be overwritten and replaced with the data from the first storage source (FirstDiskPool or FirstPassThroughDisk parameters).

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-EnableRedundancy

Specify this parameter to create redundant mirror paths between servers. Redundant mirror paths provide two mirror paths going in each direction between servers. Redundant paths can be either iSCSI or Fibre Channel. Each server is required to have two FC or two iSCSI ports with the mirror role enabled (see Set-DcsServerPortProperties). Port paths are automatically selected.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-FirstLogicalDisk<Object>

LogicalDiskData object or ID of the logical disk used as the first storage source of a mirrored or dual virtual disk. Data on the specified first logical disk will be mirrored to the second logical disk. The LogicalDiskData object can be retrieved by invoking Get-DcsLogicalDisk.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-SecondLogicalDisk<Object>

LogicalDiskData object or ID of the logical disk used as the second storage source of a mirrored or dual virtual disk. IMPORTANT: The data on the specified second logical disk will be overwritten and replaced with the data from the first logical disk. The LogicalDiskData object can be retrieved by invoking Get-DcsLogicalDisk.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-BackupLogicalDisk<Object>

LogicalDiskData object or ID of the logical disk used as the backup storage source of a mirrored virtual disk. IMPORTANT: The data on the specified second logical disk will be overwritten and replaced with the data from the first logical disk. The LogicalDiskData object can be retrieved by invoking Get-DcsLogicalDisk.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-SharedPool<String>

Name or ID that identifies a shared disk pool to use when creating a dual virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-ApproveSMPA

Specify this parameter to acknowledge that all disks in the shared pool are qualified shared multi-port array disks. The shared pool must be SMPA approved in order to create dual virtual disks.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-SharedDisk<String>

Name or ID that identifies a shared physical disk. To resolve by name, the name must be unique to the server group or the server must be specified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PassThroughDisk<String>

The disk name or ID of the pass-through disk used as the storage source of a non-mirrored virtual disk. To resolve by name, the name must be unique to the server group or the server must be specified.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

LogicalDiskDataObject that identifies and describes the logical disk.

OUTPUTS

VirtualDiskDataObject that identifies and describes the virtual disk. One object is returned for each virtual disk created.

NOTES

Also see Get-DcsLogicalDisk, Add-DcsLogicalDisk, Get-DcsVirtualDisk, Set-DcsVirtualDiskProperties, Set-DcsVirtualDiskSize, Serve-DcsVirtualDisk, Enable-DcsDataProtection, Enable-DcsSequentialStorage, Add-DcsSnapshot, Add-DcsReplication, Unlock-DcsPhysicalDisk.

EXAMPLES

Add-DcsVirtualDisk -Name VDisk1 -Size 100GiB -Server SSV1 -Pool SSV1Pool3
		

Add-DcsVirtualDisk -Name VDisk2 -Size "500 GiB" -SectorSize 4096 FirstServer SSV1 -SecondServer SSV2 -FirstPool SSV1Pool1 -SecondPool SSV2Pool3
		

Add-DcsVirtualDisk -Name "VD99FTL" -FirstLogicalDisk (Add-DcsLogicalDisk -Server SSV1 -Pool "Disk pool 1") -SecondLogicalDisk (Add-DcsLogicalDisk -Server SSV2 -Pool "Disk pool 2")
		

$sharedpassthru = Get-DcsSharedPhysicalDisk -Server SSV1 -PhysicalDisk "SSV1-WDC50-D1"
Add-DcsVirtualDisk -Size 50GiB -FirstServer SSV1 -SecondServer SSV2 -SharedDisk $sharedpassthru
		

$ldiskSSVVM5 = Get-DcsLogicalDisk -Server SSVVM5 | where {$_.Virtualized -eq $False}
$ldiskSSVVM6 = Get-DcsLogicalDisk -Server SSVVM6 | where {$_.MappingName -eq $ldiskSSVVM5.MappingName}
Add-DcsVirtualDisk -FirstLogicalDisk $ldiskSSVVM5.Id -SecondLogicalDisk $ldiskSSVVM6.Id -Size 50GiB
		

Add-DcsVirtualDisk -Size 40GiB -FirstServer SSVVM5 -SecondServer SSVVM6 -SharedPool "Shared disk pool 1" -ApproveSMPA