Freigeben über

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

Die Read-SCVirtualMachine Cmdlet aktualisiert die Eigenschaften eines virtuellen Computers, sodass die VMM-Konsole aktualisierte Informationen über den virtuellen Computer anzeigt. Die aktualisierten Eigenschaften umfassen Name, Status, Host, Owner, CPUAverage, Service, OperatingSystemund 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 Objekt des virtuellen Computers mit dem Namen 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 wurde, werden aktuelle Informationen zu diesem virtuellen Computer angezeigt.

Beispiel 2: Aktualisieren aller virtuellen Computer auf Hosts, deren Name der angegebenen Zeichenfolge entspricht

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 Objekte des virtuellen Computers von VMMServer01 auf Hosts ab, deren Name die Zeichenfolge VMM enthält, und speichert diese Objekte des virtuellen Computers dann 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 eine Benutzerbestätigung zu verlangen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:VM
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMHost

Gibt ein Hostobjekt eines virtuellen Computers an. VMM unterstützt Hyper-V Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

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

Typ:Host
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualMachine

Hinweise

  • Für dieses Cmdlet ist ein Objekt des virtuellen Computers erforderlich, das mithilfe des cmdlets Get-SCVirtualMachine abgerufen werden kann.