PowerCLI Reference

Set-FloppyDrive

Synopsis

This cmdlet modifies the configuration of the specified virtual floppy drive.

Syntax

Set-FloppyDrive [-Floppy] <FloppyDrive[]> [-FloppyImagePath <String>] [-HostDevice <String>] [-NoMedia] [-StartConnected <Boolean>] [-Connected <Boolean>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-FloppyDrive
New-FloppyDrive
Remove-FloppyDrive

Detailed Description

This cmdlet modifies the configuration of the specified virtual floppy drive. If a floppy image path is provided, the cmdlet sets the floppy drive to point to the image. Also, the cmdlet updates the StartConnected and Connected properties. If the value of the NoMedia parameter is $true, the cmdlet removes the floppy drive's media backing and disconnects it. The FloppyImagePath, HostDevice, and NoMedia parameters cannot be used together. The Connected parameter can be specified only if the corresponding virtual machine is powered on.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
FloppyFloppyDrive[]Specifies the virtual floppy drive you want to configure.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
ConnectedBooleanIf the value is $true, the virtual floppy drive is connected after its creation. If the value is $false, the floppy drive is disconnected. This parameter can be specified only if the corresponding virtual machine is powered on.falsefalse
FloppyImagePathStringSpecifies the datastore path to the floppy image file that backs the virtual floppy drive. Do not use this parameter when the HostDevice and NoMedia parameters are specified.falsefalse
HostDeviceStringSpecifies the path to the floppy drive on the host that backs this virtual floppy drive. Do not use this parameter when the FloppyImagePath and NoMedia parameters are specified.falsefalse
NoMediaSwitchParameterIndicates that the floppy drive is to have no media (similar to removing the floppy from a physical drive). Do not use this parameter when the FloppyImagePath and HostDevice parameters are specified.falsefalse
StartConnectedBooleanIf the value is $true, the virtual floppy drive starts connected when its associated virtual machine powers on. If the value is $false, it starts disconnected.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

Zero or more modified FloppyDrive objects

Notes

Examples

-------------- Example 1 --------------

Set-FloppyDrive -Floppy $floppy -StartConnected:$true

Sets a floppy to start connected.


Copyright © VMware, Inc. All rights reserved.