Get-VMIdeController
Get-VMIdeController
Gets the IDE controllers of a virtual machine or snapshot.
Syntax
Parameter Set: VMName
Get-VMIdeController [-VMName] <String[]> [[-ControllerNumber] <Int32]> ] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [ <CommonParameters>]
Parameter Set: VMObject
Get-VMIdeController [-VM] <VirtualMachine[]> [[-ControllerNumber] <Int32]> ] [ <CommonParameters>]
Parameter Set: VMSnapshot
Get-VMIdeController [-VMSnapshot] <VMSnapshot> [[-ControllerNumber] <Int32]> ] [ <CommonParameters>]
Detaillierte Beschreibung
The Get-VMIdeController cmdlet gets the IDE controllers of a virtual machine or snapshot.
Parameter
-CimSession<Microsoft.Management.Infrastructure.CimSession[]>
Das Cmdlet wird in einer Remotesitzung oder auf einem Remotecomputer ausgeführt. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, wie z. B. die Ausgabe eines New-CimSession oder Get-CimSession-Cmdlets. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-ComputerName<String[]>
Specifies one or more Hyper-V hosts on which the IDE controllers of a virtual machine or snapshot are to be retrieved. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-ControllerNumber<Int32]>
Specifies the number of the IDE controller to be retrieved. Allowed values are 0 and 1.
Aliase |
none |
Erforderlich? |
false |
Position? |
2 |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Credential<System.Management.Automation.PSCredential[]>
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-VM<VirtualMachine[]>
Specifies the virtual machine whose IDE controllers are to be retrieved.
Aliase |
none |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-VMName<String[]>
Specifies the name of the virtual machine whose IDE controllers are to be retrieved.
Aliase |
none |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
-VMSnapshot<VMSnapshot>
Specifies the snapshot whose IDE controllers are to be retrieved.
Aliase |
VMCheckpoint |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
- Microsoft.HyperV.PowerShell.IDEController
Beispiele
Example 1
Gets all IDE controllers belonging to virtual machine TestVM.
PS C:\> Get-VMIdeController TestVM
Example 2
Gets the first IDE controller belonging to virtual machine TestVM.
PS C:\> Get-VMIdeController TestVM –ControllerNumber 0