Get-SCVirtualMachine
Ruft VM-Objekte ab.
Syntax
All (Standardwert)
Get-SCVirtualMachine
[[-Name] <String>]
[-VMMServer <ServerConnection>]
[-All]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VMHostGroup
Get-SCVirtualMachine
[[-Name] <String>]
-VMHost <Host>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Cloud
Get-SCVirtualMachine
[[-Name] <String>]
-Cloud <Cloud>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Service
Get-SCVirtualMachine
[[-Name] <String>]
-Service <Service>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ComputerTier
Get-SCVirtualMachine
[[-Name] <String>]
-ComputerTier <ComputerTier>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
StorageQoSPolicy
Get-SCVirtualMachine
[[-Name] <String>]
-StorageQoSPolicy <StorageQoSPolicy>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ID
Get-SCVirtualMachine
[[-Name] <String>]
[-VMMServer <ServerConnection>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Get-SCVirtualMachine werden ein oder mehrere VM-Objekte aus der Virtual Machine Manager (VMM)-Datenbank abgerufen. Mit diesem Cmdlet werden virtuelle Maschinen abgerufen, die auf einem Host für virtuelle Maschinen 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"
Mit diesem Befehl werden alle VM-Objekte auf VMMServer01 abgerufen und Informationen zu diesen VM-Objekten angezeigt.
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
Mit diesem Befehl werden alle VM-Objekte in VMMServer01 abgerufen und die Werte der angegebenen Eigenschaften angezeigt.
Beispiel 3: Abrufen eines virtuellen Computers anhand des Namens, der auf einem angegebenen Bibliothekserver 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 her.
Der zweite Befehl ruft das VM-Objekt mit dem Namen VM02 ab, das auf LibraryServer01 gespeichert ist, und zeigt dann den Namen des virtuellen Computers, den Namen des Bibliothekservers 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 her.
Mit dem zweiten Befehl werden alle auf VMHost01 bereitgestellten VM-Objekte abgerufen und Informationen zu diesen virtuellen Computern angezeigt.
Parameter
-All
Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft.
Der Befehl Get-SCVirtualDiskDrive -All ruft z. B. alle Objekte des virtuellen Laufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes Objekt des virtuellen Laufwerks zugeordnet ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
All
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Cloud
Gibt ein privates Cloud-Objekt an.
Parametereigenschaften
| Typ: | Cloud |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Cloud
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ComputerTier
Gibt ein Objekt auf Computerebene an.
Parametereigenschaften
| Typ: | ComputerTier |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerTier
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ID
Gibt die eindeutige ID für ein Objekt an.
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ID
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | UserRole |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Service
Gibt ein VMM-Dienstobjekt an.
Parametereigenschaften
| Typ: | Service |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Service
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-StorageQoSPolicy
Gibt die QoS-Richtlinie (Quality of Service) für die virtuellen Computer an, die dieses Cmdlet abruft.
Parametereigenschaften
| Typ: | StorageQoSPolicy |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
StorageQoSPolicy
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMHost
Gibt ein Hostobjekt für eine virtuelle Maschine an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.
Weitere Informationen zu den einzelnen Hosttypen finden Sie unter dem Cmdlet Add-SCVMHost .
Parametereigenschaften
| Typ: | Host |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
VMHostGroup
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
Parametereigenschaften
| Typ: | ServerConnection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
VirtualMachine
Dieses Cmdlet gibt ein VirtualMachine-Objekt zurück.