PowerCLI Reference

New-FloppyDrive

Synopsis

This cmdlet creates a new virtual floppy drive.

Syntax

New-FloppyDrive [-VM] <VirtualMachine> [-FloppyImagePath <String>] [-HostDevice <String>] [-NewFloppyImagePath <String>] [-Server <VIServer[]>] [-StartConnected] [-Confirm] [-WhatIf] [<CommonParameters>]

Related Commands

Online Version
Get-FloppyDrive
Remove-FloppyDrive
Set-FloppyDrive

Detailed 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

NameTypeDescriptionRequired?Pipeline InputDefault Value
VMVirtualMachineSpecifies the virtual machine to which you want to attach the new virtual floppy drive. Passing multiple values to this parameter is obsolete.trueTrue (ByValue)
ConfirmSwitchParameterIf 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.falseFalse
FloppyImagePathStringSpecifies the datastore path to the floppy image file backing the virtual floppy drive. Do not use this parameter together with the HostDevice parameter.falseFalse
HostDeviceStringSpecifies 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.falseFalse
NewFloppyImagePathStringSpecifies a new datastore path to a floppy image file backing the virtual floppy drive. Do not use this parameter together with the HostDevice parameter.falseFalse
ServerVIServer[]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.falseFalse
StartConnectedSwitchParameterIndicates that the virtual floppy drive starts connected when its associated virtual machine powers on.falseFalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falseFalse

Return Type

The one or more newly created FloppyDrive objects

Notes

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.


Copyright © VMware, Inc. All rights reserved.