Debug-VM

Debug-VM

Debugs a virtual machine.

Syntax

Parameter Set: Name
Debug-VM [-Name] <String[]> [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Force] [-InjectNonMaskableInterrupt] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMObject
Debug-VM [-VM] <VirtualMachine[]> [-AsJob] [-Force] [-InjectNonMaskableInterrupt] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detaillierte Beschreibung

The Debug-VM cmdlet debugs a virtual machine.

Parameter

-AsJob

Runs the cmdlet as a background job.

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

-ComputerName<String[]>

Specifies an array of Hyper-V hosts. The cmdlet debugs the virtual machines on the hosts you specify.

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

-Force

Erzwingt die Ausführung des Befehls, ohne den Benutzer zur Bestätigung aufzufordern.

-InjectNonMaskableInterrupt

Indicates that the cmdlet sends a nonmaskable interrupt (NMI) to the virtual machine. An interrupt handler must process a nonmaskable interrupt.

-Name<String[]>

Specifies an array of names of virtual machines to be debugged.

-Passthru

Gibt ein Objekt an, das das Element darstellt, mit dem Sie arbeiten. Dieses Cmdlet generiert standardmäßig keine Ausgabe.

-VM<VirtualMachine[]>

Specifies an array of virtual machine objects that are to be debugged. To obtain virtual machine objects, use the Get-VM cmdlet.

-Confirm

Fordert Sie vor der Ausführung des Cmdlet zum Bestätigen auf.

-WhatIf

Zeit, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Beispiele

Example 1

This example injects a non-maskable interrupt into the virtual machine named “VM to Debug”. A kernel debugger should be connected to the guest operating system before attempting to do this.

PS C:\> debug-vm "VM to Debug" -InjectNonMaskableInterrupt -Force