Udostępnij za pośrednictwem

Stop-SCVirtualMachine

  • Odwołanie
Moduł:
VirtualMachineManager

Zatrzymuje maszyny wirtualne zarządzane przez program VMM.

Składnia

Stop-SCVirtualMachine
    [-VM] <VM>
    [-Shutdown]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-SaveState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-DiscardSavedState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Stop-SCVirtualMachine zatrzymuje co najmniej jedną uruchomioną maszynę wirtualną na hostach zarządzanych przez program Virtual Machine Manager (VMM) i zwraca obiekt maszyny wirtualnej w stanie zatrzymanym.

To polecenie cmdlet zatrzymuje maszynę wirtualną tak samo jak zamykanie systemu operacyjnego na komputerze. Jeśli określisz parametr Force, to polecenie cmdlet zatrzymuje maszynę wirtualną tak samo jak wyłączenie komputera.

Aby wznowić zatrzymaną maszynę wirtualną, użyj polecenia cmdlet Start-SCVirtualMachine.

Przykłady

Przykład 1. Zatrzymywanie określonej maszyny wirtualnej

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

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

Drugie polecenie zatrzymuje maszynę wirtualną przechowywaną w $VM i wyświetla informacje o zatrzymanych obiektach.

Przykład 2. Zatrzymywanie wielu maszyn wirtualnych

PS C:\> $VMs = Get-SCVirtualMachine | where { $_.Name -match "VM" -and $_.Status -eq "Running" }
PS C:\> $VMs | Stop-SCVirtualMachine

Pierwsze polecenie pobiera wszystkie obiekty maszyny wirtualnej, których nazwa zawiera ciąg VMM i którego bieżący stan to Uruchomiono. Następnie polecenie przechowuje te obiekty w tablicy $VMs.

Drugie polecenie przekazuje każdy obiekt maszyny wirtualnej przechowywany w $VMs do bieżącego polecenia cmdlet, które zatrzymuje każdą maszynę wirtualną. Polecenie wyświetla informacje o zatrzymanych maszynach wirtualnych.

Parametry

-DiscardSavedState

Wskazuje, że to polecenie cmdlet usuwa zapisany stan skojarzony z maszyną wirtualną.

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

-Force

Wskazuje, że to polecenie cmdlet zatrzymuje maszynę wirtualną tak samo jak wyłączenie komputera.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
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

-SaveState

Wskazuje, że to polecenie cmdlet zapisuje stan maszyny wirtualnej.

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

-Shutdown

Wskazuje, że to polecenie cmdlet zamyka maszynę wirtualną. To polecenie cmdlet używa systemu operacyjnego do bezpiecznego zamykania maszyny wirtualnej.

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

Dane wyjściowe

VirtualMachine

To polecenie cmdlet zwraca obiekt VirtualMachine.

Uwagi

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