Read-SCVirtualMachine

Referenz

Modul:: VirtualMachineManager

Aktualisiert die Eigenschaften eines virtuellen Computers, sodass die VMM-Konsole aktualisierte Informationen über den virtuellen Computer anzeigt.

Syntax

Read-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Read-SCVirtualMachine
    [-VMHost] <Host>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Read-SCVirtualMachine aktualisiert die Eigenschaften eines virtuellen Computers, sodass die Virtual Machine Manager -Konsole (VMM) aktualisierte Informationen über den virtuellen Computer anzeigt. Die aktualisierten Eigenschaften umfassen Name, Status, Host, Besitzer, CPUAverage, Service, OperatingSystem und andere Eigenschaften.

Beispiele

Beispiel 1: Aktualisieren von Informationen zu einem bestimmten virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Read-SCVirtualMachine -VM $VM

Der erste Befehl ruft das virtuelle Computerobjekt namens VM01 ab und speichert dieses Objekt dann in der $VM Variablen.

Der zweite Befehl aktualisiert die Eigenschaften des virtuellen Computers, der in $VM gespeichert ist. Nachdem dieser Befehl erfolgreich abgeschlossen ist, werden aktuelle Informationen zu diesem virtuellen Computer angezeigt.

Beispiel 2: Aktualisieren aller virtuellen Computer auf Hosts, deren Name mit der angegebenen Zeichenfolge übereinstimmt

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object { $_.VMHost.Name -Match "VMM" }
PS C:\> $VMs | Read-SCVirtualMachine

Der erste Befehl ruft alle virtuellen Computerobjekte von VMMServer01 auf Hosts ab, deren Name die Zeichenfolge VMM enthält, und speichert dann diese virtuellen Computerobjekte im $VMs Array.

Der zweite Befehl aktualisiert die Eigenschaften jedes virtuellen Computerobjekts, das in $VMs gespeichert ist.

Parameter

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

Gibt ein Objekt virtueller Maschinen an.

Type:	VM
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMHost

Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im Add-SCVMHost-Cmdlet .

Type:	Host
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Ausgaben

VirtualMachine

Hinweise

Dieses Cmdlet erfordert ein virtuelles Computerobjekt, das mithilfe des Cmdlets Get-SCVirtualMachine abgerufen werden kann.