New-SCVirtualDiskDrive

Creates a virtual disk drive object on a virtual machine deployed on a host managed by VMM, or on a template in the VMM library.

The New-SCVirtualDiskDrive cmdlet creates a virtual disk drive object on a virtual machine deployed on a host managed by System Center Virtual Machine Manager (VMM), or creates a virtual disk drive object on a template in the VMM library.

A virtual hard disk file (a Windows-based .vhd file or a VMware-based.vmdk file) that is stored on a VMM library share, but is not attached to a virtual disk drive, exists as a standalone object in the library.

A pass-through disk is a disk on a Hyper-V or VMware ESX host that a virtual machine on that host can use as an alternative to using a virtual hard disk. The corresponding term used by VMware for a pass-through disk is Raw Device Mapping, or RDM. The host disk can be either a hard disk on the host 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
   Hyper-V					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


NOTE: You cannot create a checkpoint of a pass-through disk because checkpoint creation is designed to work with virtual hard disks.

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

AnyStorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Identifies a placeholder parameter that is used to indicate the creation of pass-through disks within a new virtual machine job group.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

AnyStorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Identifies a placeholder parameter that is used to indicate the creation of pass-through disks within a new virtual machine job group.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

AnyStorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Identifies a placeholder parameter that is used to indicate the creation of pass-through disks within a new virtual machine job group.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

AnyStorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Identifies a placeholder parameter that is used to indicate the creation of pass-through disks within a new virtual machine job group.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

UseLocalVirtualHardDisk

Required?	false
Accept Pipeline Input?	false
Position?	named

Verifies that the VHD file (or files) to be used to create the virtual machine exist and are stored on the destination host.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

UseLocalVirtualHardDisk

Required?	false
Accept Pipeline Input?	false
Position?	named

Verifies that the VHD file (or files) to be used to create the virtual machine exist and are stored on the destination host.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

UseLocalVirtualHardDisk

Required?	false
Accept Pipeline Input?	false
Position?	named

Verifies that the VHD file (or files) to be used to create the virtual machine exist and are stored on the destination host.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

UseLocalVirtualHardDisk

Required?	false
Accept Pipeline Input?	false
Position?	named

Verifies that the VHD file (or files) to be used to create the virtual machine exist and are stored on the destination host.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies a virtual hard disk object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies a virtual hard disk object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies a virtual hard disk object.

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies a virtual hard disk object.

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies a virtual hard disk object.

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies a virtual hard disk object.

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

StorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

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 referrred 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

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

StorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

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 referrred 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

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

StorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

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 referrred 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

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

StorageDisk

Required?	true
Accept Pipeline Input?	false
Position?	named

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 referrred 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

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Dynamic

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk can expand dynamically. 

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

Fixed

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk is fixed in size. 

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Dynamic

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk can expand dynamically. 

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

Fixed

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk is fixed in size. 

JobGroup

Required?	true
Accept Pipeline Input?	false
Position?	named

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. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Dynamic

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk can expand dynamically. 

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

Fixed

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk is fixed in size. 

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Dynamic

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk can expand dynamically. 

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

Fixed

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk is fixed in size. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VMTemplate

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM template object used to create virtual machines.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Dynamic

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk can expand dynamically. 

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

Fixed

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk is fixed in size. 

IDE

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies IDE as the bus type to which to attach a virtual disk drive object or a virtual DVD drive object configured on a virtual machine or on a template.

Example format: -IDE –Bus 0 –LUN 1 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Dynamic

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk can expand dynamically. 

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Bus

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the IDE bus to which to attach a virtual disk drive or virtual DVD drive, or the SCSI bus to which to attach a virtual disk drive. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

NOTE: See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

FileName

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the file name to use when you rename a virtual hard disk file as you add it to a virtual machine.

Fixed

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies that a virtual hard disk is fixed in size. 

LUN

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies the logical unit number (LUN) for a virtual disk drive object or for a virtual DVD drive object on an IDE bus, or for a virtual disk drive object on a SCSI bus. 

Example format: -IDE -Bus 1 -LUN 0
Example format: -SCSI -Bus 0 -LUN 1

SCSI

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies SCSI as the bus type to which to attach a virtual disk drive object configured on a virtual machine or on a template. 

Example format: -SCSI -Bus 0 -LUN 0

VirtualHardDiskSizeMB

Required?	true
Accept Pipeline Input?	false
Position?	named

Specifies, in megabytes (MB), the size of a fixed virtual hard disk file or the maximum possible size of a dynamically expanding virtual hard disk file.

VM

Required?	true
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a virtual machine object.

BootVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a boot volume.

JobVariable

Required?	false
Accept Pipeline Input?	false
Position?	named

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

Path

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the destination path for the operation.

Example formats:
 Local path	 -Path "F:\"
 UNC path		 -Path "\\Library\Templates"
 Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
 VMware ESX path  –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
 Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”

Wildcards are supported for "Get" cmdlets and when you specify the UNC path:

Example format:
 UNC path		 -Path "\\VMHostServer\MyVMs\*VM*"

PROTipID

Required?	false
Accept Pipeline Input?	false
Position?	named

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

ReturnImmediately

Required?	false
Accept Pipeline Input?	false
Position?	named

RunAsynchronously

Required?	false
Accept Pipeline Input?	false
Position?	named

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

StorageClassification

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies a storage classification object.

SystemVolume

Required?	false
Accept Pipeline Input?	false
Position?	named

Indicates that the volume attached to the VirtualDiskDrive is a system volume.

VMMServer

Required?	false
Accept Pipeline Input?	true (ByValue)
Position?	named

Specifies a VMM server object.

VolumeType

Required?	false
Accept Pipeline Input?	false
Position?	named

Specifies the volume type for a virtual hard disk. Valid values: Boot, System, BootAndSystem, None.

Requires a VMM virtual hard disk object, which can be retrieved by using the Get-SCVirtualHardDisk cmdlet.

PS C:\> $VHD = Get-SCVirtualHardDisk -Name "Blank Disk - Small"
PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> New-SCVirtualDiskDrive -VMTemplate $VMTemplate -IDE -Bus 1 -Lun 1 -VirtualHardDisk $VHD

The first command gets the virtual hard disk object named "Blank Disk - Small" from the VMM library stores the object in the $VHD variable.

The second command gets the virtual machine template object named VMTemplate01 from the library stores the in the $Template variable.

The last command creates a new virtual disk drive on VMTemplate01 and attaches the virtual hard disk stored in $VHD to the second channel in the second slot of the IDE bus on the virtual disk drive.

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualDiskDrive -VM $VM -Dynamic -Filename "Test" -IDE -Size 20000 -Bus 0 -LUN 1

The first command gets the virtual machine object named VM01 and stores the object in the $VM variable.

The second command creates a new dynamic virtual disk drive on the first IDE channel in the second slot of the virtual machine and specifies its size as 19.5 GB.

PS C:\> $JobGroupID = [Guid]::NewGuid().ToString()
PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Location -eq "\\LibServer01.Contoso.com\MSSCVMMLibrary\VHDs\Blank Disk - Large.vhd"} 
PS C:\> New-SCVirtualDiskDrive -IDE -Bus 0 -LUN 1 -JobGroup $JobGroupID -VirtualHardDisk $VHD 
PS C:\> $HWProfile = Get-SCHardwareProfile | where {$_.Name -match "NewHWProfile01"}
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> New-SCVirtualMachine -Name "VM10" -Description "New Virtual Machine VM10" -VMMServer "VMMServer01.Contoso.com" -Owner "Contoso\Katarina" -VMHost $VMHost -Path "D:\VirtualMachinePath" -HardwareProfile $HWProfile -JobGroup $JobGroupID -RunAsynchronously -StartAction NeverAutoTurnOnVM -StopAction SaveVM

The first command generates a new globally unique identifier (GUID) and stores the GUID string in variable $JobGroupID. The job group ID functions as an identifier that groups subsequent commands that include $JobGroupID into a single job group.

The second command gets the virtual hard disk object from the VMM library location \\LibraryServer01.Contoso.com\MSSCVMMLibrary\VHDs\Blank Disk - Large.vhd and stores the object in the $VHD variable.

The third command creates a new virtual hard disk drive object and assignes the new object to IDE Bus 0 and LUN 1. This command also attaches the virtual hard disk stored in $VHD to the new object. By using the JobGroup parameter, this command will run just before the last command that invokes the JobGroup and associate the new virtual hard drive object with the new virtual machine created in the last command.

The fourth command gets the hardware profile object that contains the string "NewHWProfile01" in its name and stores the object in the $HwProfile variable.

The fifth command gets the host object named VMHost03, stores the host object in the $VMHost variable.

The last command creates a new virtual machine named VM10 using the hardware settings stored in $HWProfile, deploys the virtual machine on VMHost03, and specifies that the virtual machine is not automatically started when the host starts and is put into a saved state when the virtualization service stops. This command uses the JobGroup parameter to indicate that that any previous cmdlets that use the same JobGroup ID is run prior to creating the new virtual machine. In this case, the New-SCVirtualDiskDrive cmdlet from the third command creates a virtual disk drive and associates it with the new virtual machine.

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost04.Contoso.com"
PS C:\> $HostDisk = @(Get-SCStorageDisk -VMHost $VMHost | where {$_.IsPassThroughCapable -eq $True})
PS C:\> New-SCVirtualDiskDrive -VM $VM -HostDisk $HostDisk[0] -SCSI -Bus 0 -LUN 1

The first command gets the virtual machine object named VM04 and stores the object in the $VM variable.

The second command gets the host object named VMHost04 and stores the object in the $VMHost variable.

The third command gets all storage disk objects on VMHost04 that are pass-through capable and stores the objects in the $HostDisk variable. Using the "@" symbol and parentheses ensures that the command stores the results in an array, in case the command returns a single object or a null value.

The last command creates a new virtual disk drive object that is connected to a physical host disk on VMHost04. The virtual disk drive is attached to the second slot of the first SCSI bus on VM04. This example assumes the virtual machine already has a SCSI controller.