Sdílet prostřednictvím

Read-SCVirtualMachine

  • Reference
Modul:
VirtualMachineManager

Aktualizuje vlastnosti virtuálního počítače tak, aby konzola VMM zobrazovala aktualizované informace o virtuálním počítači.

Syntaxe

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

Rutina Read-SCVirtualMachine aktualizuje vlastnosti virtuálního počítače tak, aby konzola nástroje Virtual Machine Manager (VMM) zobrazila aktualizované informace o virtuálním počítači. Mezi aktualizované vlastnosti patří Name, Status, Host, Owner, CPUAverage, Service, OperatingSystema další vlastnosti.

Příklady

Příklad 1: Aktualizace informací o konkrétním virtuálním počítači

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

První příkaz získá objekt virtuálního počítače s názvem VM01 a pak tento objekt uloží do proměnné $VM.

Druhý příkaz aktualizuje vlastnosti virtuálního počítače uloženého v $VM. Po úspěšném dokončení tohoto příkazu se zobrazí aktuální informace o tomto virtuálním počítači.

Příklad 2: Aktualizace všech virtuálních počítačů na hostitelích, jejichž název odpovídá zadanému řetězci

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

První příkaz načte všechny objekty virtuálního počítače z VMMServer01 nasazených na hostitelích, jejichž název obsahuje řetězec VMM, a pak tyto objekty virtuálního počítače uloží do pole $VMs.

Druhý příkaz aktualizuje vlastnosti každého objektu virtuálního počítače uloženého v $VMs.

Parametry

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje proměnnou, ve které je průběh úlohy sledován a uložen.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VM

Určuje objekt virtuálního počítače.

Typ:VM
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMHost

Určuje objekt hostitele virtuálního počítače. Nástroj VMM podporuje hostitele Hyper-V, hostitele VMware ESX a hostitele Citrix XenServer.

Další informace o jednotlivých typech hostitelů najdete v rutině Add-SCVMHost.

Typ:Host
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

VirtualMachine

Poznámky

  • Tato rutina vyžaduje objekt virtuálního počítače, který lze načíst pomocí rutiny Get-SCVirtualMachine.