Syntax
New-FloppyDrive [-VM] <VirtualMachine> [-FloppyImagePath <String>] [-HostDevice <String>] [-NewFloppyImagePath <String>] [-Server <VIServer[]>] [-StartConnected] [-Confirm] [-WhatIf] [<CommonParameters>]Related Commands
Online VersionDetailed Description
This cmdlet creates a new virtual floppy drive for each of the provided virtual machines. If a floppy image path is provided, sets the floppy drive to point to the image. If both the FloppyImagePath and HostDevice parameters are specified, an error is generated.Parameters
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
VM | VirtualMachine | Specifies the virtual machine to which you want to attach the new virtual floppy drive. Passing multiple values to this parameter is obsolete. | true | True (ByValue) | |
Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | False | |
FloppyImagePath | String | Specifies the datastore path to the floppy image file backing the virtual floppy drive. Do not use this parameter together with the HostDevice parameter. | false | False | |
HostDevice | String | Specifies the path to the floppy drive on the host which will back this virtual floppy drive. Do not use this parameter together with the FloppyImagePath parameter. | false | False | |
NewFloppyImagePath | String | Specifies a new datastore path to a floppy image file backing the virtual floppy drive. Do not use this parameter together with the HostDevice parameter. | false | False | |
Server | VIServer[] | Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. | false | False | |
StartConnected | SwitchParameter | Indicates that the virtual floppy drive starts connected when its associated virtual machine powers on. | false | False | |
WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | False |
Return Type
The one or more newly created FloppyDrive objectsNotes
Examples
-------------------------- Example 1 --------------------------
New-FloppyDrive -VM VM -HostDevice '/dev/fd0' -StartConnected
Creates a floppy drive backed by the client device /dev/fd0 and sets it to start connected when the virtual machine is powered on.