vSphere PowerCLI Reference

Set-FloppyDrive

Synopsis

Changes 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

Changes 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[]Specify 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$true
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
FloppyImagePathStringSpecify the datastore path to the floppy image file that backs the virtual floppy drive. Do not use this parameter together with the HostDevice and NoMedia parameters.falsefalse
HostDeviceStringSpecify the path to the floppy drive on the host that backs this virtual floppy drive. Do not use this parameter together with the FloppyImagePath and NoMedia parameters.falsefalse
NoMediaSwitchParameterIndicate that the floppy drive is to have no media (similar to removing the floppy from a physical drive). Do not use this parameter at the same time with the FloppyImagePath and HostDevice parameters.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
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

FloppyDrive

Notes

Examples

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

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

Sets a floppy to start connected.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.