Freigeben über

Get-SCVirtualMachine

  • Referenz
Modul:
VirtualMachineManager

Ruft Objekte des virtuellen Computers ab.

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

Beschreibung

Das Cmdlet Get-SCVirtualMachine ruft ein oder mehrere virtuelle Computerobjekte aus der VMM-Datenbank (Virtual Machine Manager) ab. Dieses Cmdlet ruft virtuelle Computer ab, die auf einem Host eines virtuellen Computers bereitgestellt oder in der VMM-Bibliothek gespeichert sind.

Beispiele

Beispiel 1: Abrufen aller virtuellen Computer und Anzeigen von Informationen zu den einzelnen Computern

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

Dieser Befehl ruft alle Objekte des virtuellen Computers auf VMMServer01 ab und zeigt Informationen zu diesen Objekten des virtuellen Computers an.

Beispiel 2: Abrufen aller virtuellen Computer und Anzeigen von Informationen zu bestimmten Eigenschaften

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

Dieser Befehl ruft alle Objekte des virtuellen Computers auf VMMServer01 ab und zeigt die Werte der angegebenen Eigenschaften an.

Beispiel 3: Abrufen eines virtuellen Computers anhand des Namens, der auf einem angegebenen Bibliotheksserver gespeichert ist

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

Der erste Befehl stellt eine Verbindung mit VMMServer01 bereit.

Der zweite Befehl ruft das virtuelle Computerobjekt mit dem Namen VM02 ab, das auf LibraryServer01 gespeichert ist, und zeigt dann den Namen des virtuellen Computers, den Namen des Bibliotheksservers und den Status des virtuellen Computers an.

Beispiel 4: Abrufen aller virtuellen Computer auf dem angegebenen Host

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

Der erste Befehl stellt eine Verbindung mit VMMServer01 bereit.

Der zweite Befehl ruft alle objekte des virtuellen Computers ab, die auf VMHost01 bereitgestellt werden, und zeigt Informationen zu diesen virtuellen Computern an.

Parameter

-All

Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft. Beispielsweise ruft der Befehl Get-SCVirtualDiskDrive -All alle Objekte des virtuellen Datenträgerlaufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes objekt des virtuellen Datenträgerlaufwerks zugeordnet ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Cloud

Gibt ein privates Cloudobjekt an.

Typ:Cloud
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputerTier

Gibt ein Computerebenenobjekt an.

Typ:ComputerTier
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ID

Gibt die eindeutige ID für ein Objekt an.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines VMM-Objekts an.

Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Service

Gibt ein VMM-Dienstobjekt an.

Typ:Service
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageQoSPolicy

Gibt die QoS-Richtlinie (Quality of Service) für die virtuellen Computer an, die dieses Cmdlet abruft.

Typ:StorageQoSPolicy
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMHost

Gibt ein Hostobjekt eines virtuellen Computers an. VMM unterstützt Hyper-V Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im cmdlet Add-SCVMHost.

Typ:Host
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualMachine

Dieses Cmdlet gibt ein VirtualMachine-Objekt zurück.