Share via

Read-SCVirtualMachine

  • Riferimento
Modulo:
VirtualMachineManager

Aggiorna le proprietà di una macchina virtuale in modo che la console VMM visualizzi informazioni aggiornate sulla macchina virtuale.

Sintassi

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

Descrizione

Il cmdlet Read-SCVirtualMachine aggiorna le proprietà di una macchina virtuale in modo che la console di Virtual Machine Manager (VMM) visualizzi informazioni aggiornate sulla macchina virtuale. Le proprietà aggiornate includono Name, Status, Host, Owner, CPUAverage, Service, OperatingSystem e altre proprietà.

Esempio

Esempio 1: Aggiornare informazioni su una macchina virtuale specifica

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

Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e quindi archivia tale oggetto nella variabile $VM.

Il secondo comando aggiorna le proprietà della macchina virtuale archiviata in $VM. Al termine di questo comando, visualizza le informazioni correnti su questa macchina virtuale.

Esempio 2: Aggiornare tutte le macchine virtuali negli host il cui nome corrisponde alla stringa specificata

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

Il primo comando ottiene tutti gli oggetti macchina virtuale da VMMServer01 distribuiti negli host il cui nome contiene la stringa VMM e quindi archivia tali oggetti macchina virtuale nella matrice di $VMs.

Il secondo comando aggiorna le proprietà di ogni oggetto macchina virtuale archiviato in $VMs.

Parametri

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-JobVariable

Specifica una variabile in cui lo stato di avanzamento del processo viene monitorato e archiviato.

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

-OnBehalfOfUser

Specifica un nome utente. Questo cmdlet opera per conto dell'utente che specifica questo parametro.

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

-OnBehalfOfUserRole

Specifica un ruolo utente. Per ottenere un ruolo utente, usare il cmdlet Get-SCUserRole . Questo cmdlet opera per conto del ruolo utente specificato da questo parametro.

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

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

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

-VM

Specifica un oggetto macchina virtuale.

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

-VMHost

Specifica un oggetto host di macchina virtuale. VMM supporta host Hyper-V, host VMware ESX e host Citrix XenServer.

Per altre informazioni su ogni tipo di host, vedere il cmdlet Add-SCVMHost .

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

Output

VirtualMachine

Note

  • Questo cmdlet richiede un oggetto macchina virtuale, che può essere recuperato usando il cmdlet Get-SCVirtualMachine .