Delen via

Get-SCVirtualMachine

  • Referentie
Module:
VirtualMachineManager

Hiermee worden virtuele-machineobjecten opgehaald.

Syntax

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 opgeslagen op een virtuele-machinehost of 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 worden bijvoorbeeld alle objecten van het virtuele schijfstation opgehaald, ongeacht het object van de virtuele machine of het sjabloonobject waaraan elk object van het virtuele schijfstation is gekoppeld.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Cloud

Hiermee geeft u een privécloudobject op.

Type:Cloud
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerTier

Hiermee geeft u een computerlaagobject.

Type:ComputerTier
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ID

Hiermee geeft u de unieke id voor een object.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Service

Hiermee geeft u een VMM-serviceobject op.

Type:Service
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

Hiermee geeft u een hostobject voor de virtuele machine op. 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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Hiermee geeft u een VMM-serverobject op.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Uitvoerwaarden

VirtualMachine

Deze cmdlet retourneert een VirtualMachine-object .