Get-SCVirtualFloppyDrive
Gets a VMM virtual floppy drive objects from a virtual machine, a virtual machine template, or a hardware profile.
Syntax
All
Get-SCVirtualFloppyDrive
[-VMMServer <ServerConnection>]
[-All]
[<CommonParameters>]
HardwareProfile
Get-SCVirtualFloppyDrive
-HardwareProfile <HardwareProfile>
[<CommonParameters>]
VM
Get-SCVirtualFloppyDrive
-VM <VM>
[<CommonParameters>]
Template
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.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
All
Position: | Named |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-HardwareProfile
Specifies a hardware profile object.
Parameter properties
Type: | HardwareProfile |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
HardwareProfile
Position: | Named |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-VM
Specifies a virtual machine object.
Parameter properties
Type: | VM |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
VM
Position: | Named |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-VMMServer
Specifies a VMM server object.
Parameter properties
Type: | ServerConnection |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
All
Position: | Named |
Mandatory: | False |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-VMTemplate
Specifies a VMM template object used to create virtual machines.
Parameter properties
Type: | Template |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | Template |
Parameter sets
Template
Position: | Named |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
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.