Get-SCVirtualMachine

Referenz

Modul:: VirtualMachineManager

Ruft Virtuelle Computerobjekte 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 virtuellen Computerhost 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 virtueller Computer auf VMMServer01 ab und zeigt Informationen zu diesen virtuellen Computerobjekten 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 nach Namen, 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 namens 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 auf VMHost01 bereitgestellten virtuellen Computerobjekte ab und zeigt Informationen zu diesen virtuellen Computern an.

Parameter

-All

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

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

-Cloud

Gibt ein privates Cloudobjekt an.

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

-ComputerTier

Gibt ein Computerebenenobjekt an.

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

-ID

Gibt die eindeutige ID für ein Objekt an.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-Service

Gibt ein VMM-Dienstobjekt an.

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

-StorageQoSPolicy

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

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

-VMHost

Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

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

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

VirtualMachine

Dieses Cmdlet gibt ein VirtualMachine-Objekt zurück.