Delen via

Get-SCVirtualMachine

  • Referentie
Module:
VirtualMachineManager

Hiermee worden virtuele-machineobjecten opgehaald.

Syntaxis

Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   -VMHost <Host>
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Cloud <Cloud>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Service <Service>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -ComputerTier <ComputerTier>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

De cmdlet Get-SCVirtualMachine haalt een of meer virtuele-machineobjecten op uit de VMM-database (Virtual Machine Manager). Met deze cmdlet worden virtuele machines ophaalt die zijn geïmplementeerd op een virtuele-machinehost of die zijn opgeslagen in de VMM-bibliotheek.

Voorbeelden

Voorbeeld 1: Alle virtuele machines ophalen en informatie weergeven over elke virtuele machine

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com"

Met deze opdracht worden alle virtuele-machineobjecten op VMMServer01 opgehaald en wordt informatie over deze virtuele-machineobjecten weergegeven.

Voorbeeld 2: alle virtuele machines ophalen en informatie weergeven over specifieke eigenschappen

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Format-List -Property Name, Owner, Description, HostName, OperatingSystem, CPUCount, Memory

Met deze opdracht worden alle virtuele-machineobjecten op VMMServer01 opgehaald en worden de waarden van de opgegeven eigenschappen weergegeven.

Voorbeeld 3: een virtuele machine ophalen op naam die is opgeslagen op een opgegeven bibliotheekserver

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine | Where-Object { $_.Name -Eq "VM02" -And $_.LibraryServer -Eq "LibraryServer01" } | Select-Object Name,LibraryServer,Status

De eerste opdracht maakt verbinding met VMMServer01.

Met de tweede opdracht wordt het virtuele-machineobject met de naam VM02 opgehaald dat is opgeslagen op LibraryServer01 en wordt vervolgens de naam van de virtuele machine, de naam van de bibliotheekserver en de status van de virtuele machine weergegeven.

Voorbeeld 4: Alle virtuele machines op de opgegeven host ophalen

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com"

De eerste opdracht maakt verbinding met VMMServer01.

Met de tweede opdracht worden alle virtuele-machineobjecten opgehaald die zijn geïmplementeerd op VMHost01 en worden informatie over deze virtuele machines weergegeven.

Parameters

-All

Geeft aan dat met deze cmdlet alle onderliggende objecten onafhankelijk van het bovenliggende object worden opgehaald. Met de opdracht Get-SCVirtualDiskDrive -All bijvoorbeeld alle virtuele-schijfstationobjecten ophaalt, ongeacht het virtuele-machineobject of sjabloonobject waaraan elk object van het virtuele schijfstation is gekoppeld.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Cloud

Hiermee geeft u een privécloudobject.

Type:Cloud
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerTier

Hiermee geeft u een computerlaagobject.

Type:ComputerTier
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ID

Hiermee geeft u de unieke id voor een object.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Service

Hiermee geeft u een VMM-serviceobject op.

Type:Service
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StorageQoSPolicy

Hiermee geeft u het QoS-beleid (Quality of Service) op voor de virtuele machines die deze cmdlet ophaalt.

Type:StorageQoSPolicy
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMHost

Hiermee geeft u een hostobject voor de virtuele machine. VMM ondersteunt Hyper-V hosts, VMware ESX-hosts en Citrix XenServer-hosts.

Zie de cmdlet Add-SCVMHost voor meer informatie over elk type host.

Type:Host
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VirtualMachine

Met deze cmdlet wordt een VirtualMachine-object geretourneerd.