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] [-StorageClassification <StorageClassification> ] [-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] [-StorageClassification <StorageClassification> ] [-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] [-StorageClassification <StorageClassification> ] [-VolumeLabel <String> ] [ <CommonParameters>]
Parameter Set: ForceNewDiskIdGuid
Mount-SCStorageDisk -DiskId <Guid]> -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-JobGroup <Guid]> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-StorageClassification <StorageClassification> ] [ <CommonParameters>]
Parameter Set: ForceNewDiskIdSignature
Mount-SCStorageDisk -DiskSignature <String> -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-JobGroup <Guid]> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-StorageClassification <StorageClassification> ] [ <CommonParameters>]
Parameter Set: FullFormatGPT
Mount-SCStorageDisk -FullFormat -GuidPartitionTable -StorageDisk <StorageDisk> [-CreateClusterSharedVolume] [-DeleteClusterSharedVolume] [-DesiredUnitAllocationSizeBytes <UInt32> ] [-ForceFormat] [-JobGroup <Guid]> ] [-JobVariable <String> ] [-MountPoint <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-StorageClassification <StorageClassification> ] [-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] [-StorageClassification <StorageClassification> ] [-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] [-StorageClassification <StorageClassification> ] [-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] [-StorageClassification <StorageClassification> ] [-VolumeLabel <String> ] [ <CommonParameters>]
Detailed Description
The Mount-SCStorageDisk cmdlet mounts a storage disk.
Parameters
-CreateClusterSharedVolume
Indicates that the cmdlet creates 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 deletes 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 |
-StorageClassification<StorageClassification>
Specifies a storage classification object.
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 file system and access the pass-through disk directly. The types of host and whether each has pass-through disk support are:
Hyper-V: Supports pass-through disks and 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
Example 1: Format a new disk
The first command generates a GUID, and then 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 named VMHost01, and then stores the object in the $VMHost variable.
The third command gets the storage logical unit object named LUN01, and then stores the object in the $LU variable.
The fourth command registers LUN01 with VMHost01. Using the JobGroup parameter specifies that this command does 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 then sets the mount point to S:\. Using the JobGroup parameter specifies that this command does 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 before 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