< Back

New-FloppyDrive

Sun Jan 19, 2020 7:00 pm

NAME 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>]





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

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? 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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? 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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? 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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? true



-StartConnected [<SwitchParameter>]

Indicates that the virtual floppy drive starts connected when its associated virtual machine powers on.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



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



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? true



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



Required? false

Position? named

Default value $true

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are

modified.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

The one or more newly created FloppyDrive objects







NOTES









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



RELATED LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... Drive.html

Get-FloppyDrive

Remove-FloppyDrive

Set-FloppyDrive