Udostępnij za pośrednictwem

Read-SCVirtualMachine

  • Odwołanie
Moduł:
VirtualMachineManager

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

Składnia

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

Opis

Polecenie cmdlet Read-SCVirtualMachine aktualizuje właściwości maszyny wirtualnej, aby konsola programu Virtual Machine Manager (VMM) wyświetlała zaktualizowane informacje o maszynie wirtualnej. Zaktualizowane właściwości obejmują Name, Status, Host, Owner, CPUAverage, Service, OperatingSystemi 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 przechowuje 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ż wszystkie maszyny wirtualne na hostach, których nazwa pasuje do określonego ciągu

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 maszyn wirtualnych z programu VMMServer01 wdrożone na hostach, których nazwa zawiera ciąg VMM, a następnie przechowuje te obiekty maszyn wirtualnych 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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobVariable

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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, którą określa ten parametr.

Typ:UserRole
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VM

Określa obiekt maszyny wirtualnej.

Typ:VM
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 .

Typ:Host
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

VirtualMachine

Uwagi

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