Get-SCStorageDisk

Gets a storage disk object for the specified host from the VMM database.

Description

The Get-SCStorageDisk cmdlet gets one or more storage disk objects for the specified host from the System Center Virtual Machine Manager (VMM) database. You can use this cmdlet with the New-SCVirtualDiskDrive cmdlet to attach a pass-through disk on a virtual machine to a physical hard disk on the host on which that virtual machine is deployed.

For more information about Get-SCStorageDisk, type: "Get-Help Get-SCStorageDisk -online".

Parameters

Name

Required? false
Accept Pipeline Input? false
Position? 0
Specifies the name of a VMM object.

VMHost

Required? true
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a virtual machine host object. VMM supports Hyper-V hosts, VMware ESX hosts, and Citrix XenServer hosts. 

For more information about each type of host, type: "Get-Help Add-SCVMHost -detailed". See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Name

Required? false
Accept Pipeline Input? false
Position? 0
Specifies the name of a VMM object.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

Examples

1: Get all hard disk drives on the specified host.
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> Get-SCStorageDisk -VMHost $VMHost
The first command gets the host object named VMHost01 and stores the object in the $VMHost variable.

The second command gets all hard disk drive objects from the host stored in $VMHost and displays information about those objects to the user.
2. Get a specific hard disk drive on the host by name.
PS C:\> $StorageDisk = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" | Get-SCStorageDisk –Name "\\.\PhysicalDrive0"
PS C:\> $StorageDisk
The first command gets the host object named VMHost02 and uses the pipeline operator to pass VMHost02 to the Get-SCStorageDisk cmdlet which gets the hard disk drive object named "PhysicalDrive0" for the host. The command then stores the hard disk drive object in the $StorageDisk variable.

The second command displays the contents of $StorageDisk to the user.

See Also