Sdílet prostřednictvím

Stop-SCVirtualMachine

  • Reference
Modul:
VirtualMachineManager

Zastaví virtuální počítače spravované nástrojem VMM.

Syntaxe

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

Description

Rutina Stop-SCVirtualMachine zastaví jeden nebo více spuštěných virtuálních počítačů na hostitelích spravovaných nástrojem Virtual Machine Manager (VMM) a vrátí objekt virtuálního počítače v zastaveném stavu.

Tato rutina zastaví virtuální počítač stejně jako vypnutí operačního systému na počítači. Pokud zadáte parametr Force, tato rutina zastaví virtuální počítač stejně jako vypnutí počítače.

Pokud chcete obnovit zastavený virtuální počítač, použijte rutinu Start-SCVirtualMachine.

Příklady

Příklad 1: Zastavení zadaného virtuálního počítače

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Stop-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 zastaví virtuální počítač uložený v $VM a zobrazí informace o zastaveného objektu.

Příklad 2: Zastavení více virtuálních počítačů

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

První příkaz získá všechny objekty virtuálního počítače, jejichž název obsahuje řetězec VMM a jehož aktuální stav je Spuštěno. Příkaz pak tyto objekty uloží do pole $VMs.

Druhý příkaz předá každý objekt virtuálního počítače uložený v $VMs aktuální rutině, která zastaví každý virtuální počítač. Příkaz zobrazí informace o zastavených virtuálních počítačích.

Parametry

-DiscardSavedState

Označuje, že tato rutina odstraní uložený stav přidružený k virtuálnímu počítači.

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

-Force

Označuje, že tato rutina zastaví virtuální počítač stejně jako vypnutí počítače.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
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

-SaveState

Označuje, že tato rutina uloží stav virtuálního počítače.

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

-Shutdown

Označuje, že tato rutina vypne virtuální počítač. Tato rutina používá operační systém k řádnému vypnutí virtuálního počítače.

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

Výstupy

VirtualMachine

Tato rutina vrátí objekt VirtualMachine.

Poznámky

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