Freigeben über

Read-SCVirtualMachine

Modul:
VirtualMachineManager Module

Aktualisiert die Eigenschaften einer virtuellen Maschine, sodass in der VMM-Konsole aktualisierte Informationen über die virtuelle Maschine angezeigt werden.

Syntax

FullRefreshSingleVm (Standardwert) 

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

LightRefreshVmsOnHost 

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

Beschreibung

Mit dem Cmdlet Read-SCVirtualMachine werden die Eigenschaften eines virtuellen Computers aktualisiert, sodass in der VMM-Konsole (Virtual Machine Manager) aktualisierte Informationen zum virtuellen Computer angezeigt werden. Zu den aktualisierten Eigenschaften gehören Name, Status, Host, Owner, 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 VM-Objekt mit dem Namen VM01 ab und speichert dieses Objekt dann in der Variablen $VM.

Mit dem zweiten Befehl werden die Eigenschaften des virtuellen Computers aktualisiert, die in $VM gespeichert sind. Nachdem dieser Befehl erfolgreich abgeschlossen wurde, 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

Mit dem ersten Befehl werden alle VM-Objekte aus VMMServer01 abgerufen, die auf Hosts bereitgestellt wurden, deren Name die Zeichenfolge VMM enthält, und dann diese VM-Objekte im $VMs Array gespeichert.

Mit dem zweiten Befehl werden die Eigenschaften jedes Objekts der virtuellen Maschine aktualisiert, das in $VMs gespeichert ist.

Parameter

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FullRefreshSingleVm
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Parametereigenschaften

Typ:VM
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FullRefreshSingleVm
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHost

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

Weitere Informationen zu den einzelnen Hosttypen finden Sie unter dem Cmdlet Add-SCVMHost .

Parametereigenschaften

Typ:Host
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

LightRefreshVmsOnHost
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

VirtualMachine

Hinweise

  • Für dieses Cmdlet ist ein VM-Objekt erforderlich, das mit dem Cmdlet Get-SCVirtualMachine abgerufen werden kann.