Delen via

Read-SCVirtualMachine

  • Referentie
Module:
VirtualMachineManager

Hiermee worden de eigenschappen van een virtuele machine vernieuwd, zodat in de VMM-console bijgewerkte informatie over de virtuele machine wordt weergegeven.

Syntaxis

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

Description

De Read-SCVirtualMachine cmdlet werkt de eigenschappen van een virtuele machine bij zodat de VMM-console (Virtual Machine Manager) bijgewerkte informatie over de virtuele machine weergeeft. De bijgewerkte eigenschappen zijn Name, Status, Host, Owner, CPUAverage, Service, OperatingSystemen andere eigenschappen.

Voorbeelden

Voorbeeld 1: Informatie over een specifieke virtuele machine vernieuwen

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald en wordt dat object vervolgens opgeslagen in de $VM variabele.

Met de tweede opdracht worden de eigenschappen bijgewerkt van de virtuele machine die is opgeslagen in $VM. Nadat deze opdracht is voltooid, wordt de huidige informatie over deze virtuele machine weergegeven.

Voorbeeld 2: Alle virtuele machines op hosts vernieuwen waarvan de naam overeenkomt met de opgegeven tekenreeks

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

Met de eerste opdracht worden alle virtuele-machineobjecten opgehaald van VMMServer01 die zijn geïmplementeerd op hosts waarvan de naam de tekenreeks VMM bevat en slaat u deze virtuele-machineobjecten vervolgens op in de $VMs matrix.

Met de tweede opdracht worden de eigenschappen bijgewerkt van elk object van de virtuele machine dat is opgeslagen in $VMs.

Parameters

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u een variabele op waarin de voortgang van de taak wordt bijgehouden en opgeslagen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VM

Hiermee geeft u een virtuele-machineobject.

Type:VM
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMHost

Hiermee geeft u een hostobject voor de virtuele machine. VMM ondersteunt Hyper-V hosts, VMware ESX-hosts en Citrix XenServer-hosts.

Zie de cmdlet Add-SCVMHost voor meer informatie over elk type host.

Type:Host
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VirtualMachine

Notities

  • Voor deze cmdlet is een virtuele-machineobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualMachine.