Get-SCPerformanceData
Ruft Leistungsdaten für Hostgruppen, Cluster, Hosts und virtuelle Maschinen ab.
Syntax
Get-SCPerformanceData
[-VM] <VM>
[-VMMServer <ServerConnection>]
-TimeFrame <String>
-PerformanceCounter <String>
[<CommonParameters>] Get-SCPerformanceData
[-VMHost] <Host>
[-VMMServer <ServerConnection>]
-TimeFrame <String>
-PerformanceCounter <String>
[<CommonParameters>] Get-SCPerformanceData
[-VMHostCluster] <HostCluster>
[-VMMServer <ServerConnection>]
-TimeFrame <String>
-PerformanceCounter <String>
[<CommonParameters>] Get-SCPerformanceData
[-VMHostGroup] <HostGroup>
[-VMMServer <ServerConnection>]
-TimeFrame <String>
-PerformanceCounter <String>
[<CommonParameters>] Get-SCPerformanceData
[-VMMServer <ServerConnection>]
-PerformanceCounter <String>
[-AllVNIC]
[<CommonParameters>] Get-SCPerformanceData
[-VMMServer <ServerConnection>]
-PerformanceCounter <String>
[-AllVM]
[<CommonParameters>] Get-SCPerformanceData
[-VMMServer <ServerConnection>]
-PerformanceCounter <String>
[-AllVMNetworkGateway]
[<CommonParameters>] Beschreibung
Das Cmdlet Get-SCPerformanceData ruft Leistungsdaten für Hostgruppen, Cluster, Hosts und virtuelle Computer ab. Sie können Daten für die folgenden Leistungsindikatoren anfordern:
CPU-Auslastung
Speicherauslastung
Nutzung der Speicher-IOPS
Netzwerk-E/A-Nutzung
Energieeinsparung
Beispiele
Beispiel 1: Abrufen von Leistungsdaten für eine Hostgruppe
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> Get-SCPerformanceData -VMHostGroup $HostGroup -PerformanceCounter "MemoryUsage" -Timeframe "Hour"Der erste Befehl ruft das Hostgruppenobjekt mit dem Namen HostGroup01 ab und speichert das Objekt in der Variablen $HostGroup.
Mit dem zweiten Befehl werden die Daten zur Speicherauslastung der letzten drei Stunden für HostGroup01 abgerufen.
Beispiel 2: Abrufen von Leistungsdaten für einen Cluster
PS C:\> $Cluster = Get-SCVMHostCluster -Name "Cluster01.Contoso.com"
PS C:\> Get-SCPerformanceData -VMHostCluster $Cluster -PerformanceCounter "MemoryUsage" -Timeframe "Day"Der erste Befehl ruft das Clusterobjekt mit dem Namen Cluster01 ab und speichert das Objekt in der Variablen $Cluster.
Mit dem zweiten Befehl werden die Speicherauslastungsdaten für den letzten Tag (24 Stunden) für Cluster01 abgerufen.
Beispiel 3: Abrufen von Leistungsdaten für einen angegebenen Host
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> Get-SCPerformanceData -VMHost $VMHost -PerformanceCounter "MemoryUsage" -Timeframe "Month"Der erste Befehl ruft das Hostobjekt mit dem Namen VMHost01 ab und speichert das Objekt in der Variablen $VMHost.
Mit dem zweiten Befehl werden die Speicherauslastungsdaten des letzten Monats (30 Tage) für VMHost01 gespeichert.
Beispiel 4: Abrufen von Leistungsdaten für einen angegebenen virtuellen Computer
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCPerformanceData -VM $VM -PerformanceCounter "MemoryUsage" -Timeframe "Day"Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.
Mit dem zweiten Befehl werden die Speicherauslastungsdaten für den letzten Tag (24 Stunden) für VM01 ausgegeben.
Beispiel 5: Abrufen von Leistungsdaten für alle virtuellen Computer
PS C:\> Get-SCPerformanceData -AllVM -PerformanceCounter "CPUUsage"Mit diesem Befehl werden die CPU-Auslastungsdaten für alle virtuellen Maschinen abgerufen.
Parameter
-AllVM
Gibt an, dass Daten für alle virtuellen Maschinen zurückgegeben werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllVMNetworkGateway
Gibt an, dass Daten für alle Netzwerkgateways zurückgegeben werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllVNIC
Gibt an, dass Daten für alle virtuellen Netzwerkadapter zurückgegeben werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PerformanceCounter
Gibt den zu verwendenden Leistungsindikator an. Die zulässigen Werte für diesen Parameter sind:
- CPU-Auslastung
- Speicherauslastung
- SpeicherIOPSUsage
- NetzwerkIOUsage
- Energieeinsparungen
| Typ: | String |
| Zulässige Werte: | CPUUsage, MemoryUsage, StorageIOPSUsage, NetworkIOUsage, NetworkIOSent, NetworkIOReceived, PowerSavings |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TimeFrame
Gibt den Zeitraum an, in dem Leistungsdaten erfasst werden sollen. Die zulässigen Werte für diesen Parameter sind:
- Stunde
- Tag
- Monat
| Typ: | String |
| Zulässige Werte: | Hour, Day, Month |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VM
Gibt ein Objekt eines virtuellen Computers an.
| Typ: | VM |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-VMHost
Gibt ein Hostobjekt für eine virtuelle Maschine an. Virtual Machine Manager (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 .
| Typ: | Host |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-VMHostCluster
Gibt ein VMM-Hostclusterobjekt an.
| Typ: | HostCluster |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-VMHostGroup
Gibt ein Hostgruppenobjekt für virtuelle Maschinen an.
| Typ: | HostGroup |
| Position: | 0 |
| 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
double[]
Dieses Cmdlet gibt ein Array mit double-Werten zurück.