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