Mount-SCStorageDisk

Mount-SCStorageDisk

Mounts a storage disk.

Syntax

Parameter Set: Default
Mount-SCStorageDisk -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-JobGroup <Guid> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-StorageLogicalUnit <StorageLogicalUnit> ] [ <CommonParameters>]

Parameter Set: ClusterFormatGPT
Mount-SCStorageDisk -GuidPartitionTable -JobGroup <Guid> -StorageLogicalUnit <StorageLogicalUnit> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-DesiredUnitAllocationSizeBytes <UInt32> ] [-ForceFormat] [-FullFormat] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-QuickFormat] [-RunAsynchronously] [-VolumeLabel <String> ] [ <CommonParameters>]

Parameter Set: ClusterFormatMBR
Mount-SCStorageDisk -JobGroup <Guid> -MasterBootRecord -StorageLogicalUnit <StorageLogicalUnit> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-DesiredUnitAllocationSizeBytes <UInt32> ] [-ForceFormat] [-FullFormat] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-QuickFormat] [-RunAsynchronously] [-VolumeLabel <String> ] [ <CommonParameters>]

Parameter Set: ForceNewDiskIdGuid
Mount-SCStorageDisk -DiskId <Guid> -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-JobGroup <Guid> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [ <CommonParameters>]

Parameter Set: ForceNewDiskIdSignature
Mount-SCStorageDisk -DiskSignature <String> -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-JobGroup <Guid> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [ <CommonParameters>]

Parameter Set: FullFormatGPT
Mount-SCStorageDisk -FullFormat -GuidPartitionTable -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-DesiredUnitAllocationSizeBytes <UInt32> ] [-ForceFormat] [-JobGroup <Guid> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-VolumeLabel <String> ] [ <CommonParameters>]

Parameter Set: FullFormatMBR
Mount-SCStorageDisk -FullFormat -MasterBootRecord -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-DesiredUnitAllocationSizeBytes <UInt32> ] [-ForceFormat] [-JobGroup <Guid> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-VolumeLabel <String> ] [ <CommonParameters>]

Parameter Set: QuickFormatGPT
Mount-SCStorageDisk -GuidPartitionTable -QuickFormat -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-DesiredUnitAllocationSizeBytes <UInt32> ] [-ForceFormat] [-JobGroup <Guid> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-VolumeLabel <String> ] [ <CommonParameters>]

Parameter Set: QuickFormatMBR
Mount-SCStorageDisk -MasterBootRecord -QuickFormat -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-DesiredUnitAllocationSizeBytes <UInt32> ] [-ForceFormat] [-JobGroup <Guid> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-VolumeLabel <String> ] [ <CommonParameters>]

Detailed Description

The Mount-SCStorageDisk cmdlet mounts a storage disk.

Parameters

-CreateClusterSharedVolume

Indicates that the cmdlet will create a Cluster Shared Volume.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DeleteClusterSharedVolume

Indicates that the cmdlet will delete a Cluster Shared Volume.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DesiredUnitAllocationSizeBytes<UInt32>

Specifies, in bytes, the default allocation size of a volume.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DiskId<Guid>

Specifies the ID of a disk object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DiskSignature<String>

Specifies the signature of a disk object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ForceFormat

Forces the formatting of the storage disk even if volumes are already present.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FullFormat

Indicates that a full format of the partition is performed.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-GuidPartitionTable

Indicates that the storage disk is a GUID partition table disk.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobGroup<Guid>

Specifies an identifier for a series of commands that will run as a set just before the final command that includes the same job group identifier runs.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MasterBootRecord

Indicates that the storage disk is a master boot record disk.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MountPoint<String>

Specifies a mount point location.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-QuickFormat

Indicates that a quick format of the partition is performed.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-StorageDisk<StorageDisk>

Specifies a disk on a Hyper-V or VMware ESX host that a virtual machine on that host can use instead of using a virtual hard disk. This disk is referred to as a pass-through disk (the corresponding VMware term is Raw Device Mapping, or RDM). The host disk is either a local hard disk or a logical unit on a Storage Area Network (SAN). VMM lets the virtual machine bypass the host's file system and access the pass-through disk directly.

TYPE OF HOST PASS-THROUGH DISK SUPPORT

------------ -------------------------

Hyper-V Supports pass-through disks

Supports converting a pass-through disk to a VHD

VMware ESX Supports pass-through disks (RDP), but not disk conversion

Citrix XenServer Does not support pass-through disks

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-StorageLogicalUnit<StorageLogicalUnit>

Specifies a storage logical unit object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VolumeLabel<String>

Specifies a label for a disk volume.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

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

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Notes

  • Requires a VMM storage disk object, which can be retrieved using the Get-SCStorageDisk cmdlet.

Examples

1: Format a new disk.

The first command generates a globally unique identifier (GUID) and stores the GUID string in variable $JobGroup. Subsequent commands that include this GUID are collected into a single job group.

The second command gets the host object nmaed VMHost01 and stores the object in the $VMHost variable.

The third command gets the storage logical unit object named LUN01 and stores the object in the $LU variable.

The fourth command registers LUN01 with VMHost01. Using the JobGroup parameter specifies tha this command will not run until just before the final command that includes the JobGroup with the same GUID.

The fifth command mounts LUN01 on VMHost01, performs a quick format on the volume, labels the volume "New Volume", and sets the mount point to S:\. Using the JobGroup parameter specifies tha this command will not run until just before the final command that includes the JobGroup with the same GUID.

The last command updates VMHost01 with the mounted storage disk. This command uses the JobGroup parameter to register and mount LUN01 prior to running Set-SCVMHost.

PS C:\> $JobGroup = [Guid]::NewGuid().ToString()
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> $LU = Get-SCStorageLogicalUnit -Name "LUN01"
PS C:\> Register-SCStorageLogicalUnit -StorageLogicalUnit $LU -VMHost $VMHost -JobGroup $JobGroup
PS C:\> Mount-SCStorageDisk -QuickFormat -MasterBootRecord -VolumeLabel "New Volume" -StorageLogicalUnit $LU -MountPoint "S:\" -JobGroup $JobGroup
PS C:\> Set-SCVMHost -VMHost $VMHost -JobGroup $JobGroup