NAME

Serve-DcsVirtualDisk

SYNOPSIS

Serves a virtual disk to a client, host group, or server. Snapshots and rollbacks are virtual disks and can also be served. This operation can also be performed on a virtual disk group.

SYNTAX

Serve-DcsVirtualDisk   -Machine <String>   -VirtualDisk <Object>   [ -StartingLun <UInt64> ]   [ -EnableRedundancy]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Serve-DcsVirtualDisk   -Machine <String>   -VirtualDiskGroup <String>   [ -StartingLun <UInt64> ]   [ -EnableRedundancy]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Serve-DcsVirtualDisk   -Machine <String>   -VirtualDisk <Object>   [ -Server <String> ]   -InitiatorPort <String>   -TargetPort <String>   [ -LUN <UInt64> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Serve-DcsVirtualDisk   -VirtualDisk <Object>   -VirtualDiskGroup <String>   -HostGroup <String>   [ -EnableRedundancy]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Serves a virtual disk to a client, host group or server. Snapshots and rollbacks are virtual disks and can also be served. This operation can also be performed on a virtual disk group. For front-end non-redundant paths, the initiator and target paths can be specified. If paths are not specified, virtual disks will be served according to the standard software guidelines.

PARAMETERS

-Machine<String>

Computer name or ID that identifies a server or client (host) that will be served the virtual disk. The computer name for a machine must be unique or the names must be fully qualified.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-VirtualDisk<Object>

VirtualDiskData object, name, or ID that identifies a virtual disk to serve. Snapshots and rollbacks are virtual disks and can also be served if specified with this parameter.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-StartingLun<UInt64>

Use this parameter to serve virtual disks beginning with the specified LUN number. The LUNs will be assigned using consecutive numbers beginning with the starting LUN. A sufficient number of consecutive LUNs must be available to complete the operation. Valid values are 0 - 254.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-EnableRedundancy<SwitchParameter>

Specify this parameter to create redundant paths. Redundant paths creates two paths from the specified machine to each server. The server must have two ports (Fibre Channel or iSCSI) with the front-end role enabled (see Set-DcsServerPortProperties). Port paths are automatically selected.

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

-VirtualDiskGroup<String>

VirtualDiskGroupData object, name or ID that identifies the virtual disk group to serve.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Server<String>

Computer name, or ID that identifies a server. Computer names must be unique or the names must be fully qualified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-InitiatorPort<String>

Name, address, or ID of the initiator port when specifying the front-end path.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-TargetPort<String>

Name, address, or ID of the target port when specifying the front-end path.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LUN<UInt64>

The number to assign to the logical unit (LUN). If not specified, the next available LUN will be assigned.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-HostGroup<String>

Name or ID that identifies the host group, if serving to a host group.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

INPUTS

VirtualDiskData : Object that identifies the virtual disk.

OUTPUTS

VirtualLogicalUnitData : Object that identifies and describes the virtual logical unit (path to the logical disk on a server). One object is returned for every path created.

NOTES

Also see related cmdlets Unserve-DcsVirtualDisk, Add-DcsvCenterDataStore, Set-DcsHypervisorHost. See Add-DcsVirtualLogicalUnit (-MappingType) to add mirror paths to virtual disks.

EXAMPLES

Serve-DcsVirtualDisk -Machine Host3 -VirtualDisk "Virtual disk 1"
		

Add-DcsVirtualDisk -Size 50GiB -Count 5 -FirstServer StorageSvr001 -SecondServer StorageSvr002 -FirstPool "Disk pool 1" -SecondPool "Disk pool 2" -EnableRedundancy | Serve-DcsVirtualDisk -Machine HostVM1 -StartingLun 20
		

Serve-DcsVirtualDisk -Machine Host3 -VirtualDisk "Virtual disk 1" -InitiatorPort "iSCSI Port 1" -TargetPort "Server iSCSI Port 3" -Server SSV2
		

Serve-DcsVirtualDisk -VirtualDiskGroup "VDGroup1" -HostGroup "HostGroup1"