Udostępnij przez

Read-SCVirtualMachine

Moduł:
VirtualMachineManager Module

Odświeża właściwości maszyny wirtualnej, tak aby konsola programu VMM wyświetlała zaktualizowane informacje o maszynie wirtualnej.

Składnia

FullRefreshSingleVm (Domyślna) 

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

Opis

Polecenie cmdlet Read-SCVirtualMachine aktualizuje właściwości maszyny wirtualnej, tak aby konsola Virtual Machine Manager (VMM) wyświetlała zaktualizowane informacje o maszynie wirtualnej. Zaktualizowane właściwości obejmują nazwę, stan, hosta, właściciela, wartość procesora,usługę, system operacyjny i inne właściwości.

Przykłady

Przykład 1: Odświeżanie informacji o określonej maszynie wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01, a następnie zapisuje ten obiekt w zmiennej $VM.

Drugie polecenie aktualizuje właściwości maszyny wirtualnej przechowywanej w $VM. Po pomyślnym zakończeniu tego polecenia zostaną wyświetlone bieżące informacje o tej maszynie wirtualnej.

Przykład 2: Odświeżanie wszystkich maszyn wirtualnych na hostach, których nazwa jest zgodna z określonym ciągiem

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

Pierwsze polecenie pobiera wszystkie obiekty maszyny wirtualnej z programu VMMServer01 wdrożone na hostach, których nazwa zawiera ciąg VMM, a następnie zapisuje te obiekty maszyny wirtualnej w tablicy $VMs.

Drugie polecenie aktualizuje właściwości każdego obiektu maszyny wirtualnej przechowywanego w $VMs.

Parametry

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FullRefreshSingleVm
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-JobVariable

Określa zmienną, w której jest śledzony i przechowywany postęp zadania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, którego określa ten parametr.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika określonej przez ten parametr.

Właściwości parametru

Typ:UserRole
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VM

Określa obiekt maszyny wirtualnej.

Właściwości parametru

Typ:VM
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FullRefreshSingleVm
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VMHost

Określa obiekt hosta maszyny wirtualnej. Program VMM obsługuje hosty Hyper-V, hosty VMware ESX i hosty Citrix XenServer.

Aby uzyskać więcej informacji na temat każdego typu hosta, zobacz polecenie cmdlet Add-SCVMHost .

Właściwości parametru

Typ:Host
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

LightRefreshVmsOnHost
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

VirtualMachine

Uwagi

  • To polecenie cmdlet wymaga obiektu maszyny wirtualnej, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualMachine .