Get-SCVirtualFloppyDrive

Reference

Module:: VirtualMachineManager

Gets a VMM virtual floppy drive objects from a virtual machine, a virtual machine template, or a hardware profile.

Syntax

Get-SCVirtualFloppyDrive
   [-VMMServer <ServerConnection>]
   [-All]
   [<CommonParameters>]

Get-SCVirtualFloppyDrive
   -HardwareProfile <HardwareProfile>
   [<CommonParameters>]

Get-SCVirtualFloppyDrive
   -VM <VM>
   [<CommonParameters>]

Get-SCVirtualFloppyDrive
   -VMTemplate <Template>
   [<CommonParameters>]

Description

The Get-SCVirtualFloppyDrive cmdlet gets one or more virtual floppy drive objects in a Virtual Machine Manager (VMM) environment from a virtual machine object, a virtual machine template object, or a hardware profile object.

In VMM, each virtual machine, virtual machine template, or hardware profile has one floppy drive. You cannot remove this floppy drive or add any additional floppy drives.

By default, the virtual floppy drive is configured as attached to no media. To configure the virtual floppy drive to use the physical floppy drive on the virtual machine host (typically, drive A:) use the Set-SCVirtualFloppyDrive cmdlet. Alternatively, you can configure the virtual floppy drive to read an existing virtual floppy disk.

Examples

Example 1: Get the virtual floppy drive from a virtual machine

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualFloppyDrive -VM $VM

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

The second command gets the virtual floppy drive object on VM01 and displays information about this drive to the user.

Example 2: Get the virtual floppy drive from a virtual machine template

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualFloppyDrive -VMTemplate $VMTemplate

The first command gets the virtual machine template object named VMTemplate01 and stores the object in the $VMTemplate variable.

The second command gets the virtual floppy drive object on VMTemplate01 and displays information about the drive to the user.

Example 3: Get the virtual floppy drive from a hardware profile

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualFloppyDrive -HardwareProfile $HWProfile

The first command gets the hardware profile named NewHWProfile01 and stores the object in the $HWProfile variable.

The second command gets the virtual floppy drive object on NewHWProfile01 and displays information about the drive to the user.

Parameters

-All

Indicates that this cmdlet gets all subordinate objects independent of the parent object. For example, the command Get-SCVirtualDiskDrive -All gets all virtual disk drive objects regardless of the virtual machine object or template object that each virtual disk drive object is associated with.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-HardwareProfile

Specifies a hardware profile object.

Type:	HardwareProfile
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

Specifies a virtual machine object.

Type:	VM
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

Specifies a VMM server object.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMTemplate

Specifies a VMM template object used to create virtual machines.

Type:	Template
Aliases:	Template
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Outputs

VirtualFloppyDrive

This cmdlet returns a VirtualFloppyDrive object.

Notes

Requires a virtual machine object, virtual machine template object, or hardware profile object, which can be retrieved by using the Get-SCVirtualMachine, Get-SCVMTemplate, or Get-SCHardwareProfile cmdlets, respectively.