Get-SCPerformanceData
ホスト グループ、クラスター、ホスト、および仮想マシンのパフォーマンス データを取得します。
構文
VM
Get-SCPerformanceData
[-VM] <VM>
-TimeFrame <String>
-PerformanceCounter <String>
[-VMMServer <ServerConnection>]
[<CommonParameters>]
Host
Get-SCPerformanceData
[-VMHost] <Host>
-TimeFrame <String>
-PerformanceCounter <String>
[-VMMServer <ServerConnection>]
[<CommonParameters>]
Cluster
Get-SCPerformanceData
[-VMHostCluster] <HostCluster>
-TimeFrame <String>
-PerformanceCounter <String>
[-VMMServer <ServerConnection>]
[<CommonParameters>]
HostGroup
Get-SCPerformanceData
[-VMHostGroup] <HostGroup>
-TimeFrame <String>
-PerformanceCounter <String>
[-VMMServer <ServerConnection>]
[<CommonParameters>]
AllVNIC
Get-SCPerformanceData
-PerformanceCounter <String>
[-VMMServer <ServerConnection>]
[-AllVNIC]
[<CommonParameters>]
AllVM
Get-SCPerformanceData
-PerformanceCounter <String>
[-VMMServer <ServerConnection>]
[-AllVM]
[<CommonParameters>]
AllVMNetworkGateway
Get-SCPerformanceData
-PerformanceCounter <String>
[-VMMServer <ServerConnection>]
[-AllVMNetworkGateway]
[<CommonParameters>]
説明
Get-SCPerformanceData コマンドレットは、ホスト グループ、クラスター、ホスト、および仮想マシンのパフォーマンス データを取得します。 次のパフォーマンス カウンターのデータを要求できます。
CPU 使用率
メモリ使用量
ストレージ IOPS の使用量
ネットワーク IO の使用状況
省電力
例
例 1: ホスト グループのパフォーマンス データを取得する
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> Get-SCPerformanceData -VMHostGroup $HostGroup -PerformanceCounter "MemoryUsage" -Timeframe "Hour"
最初のコマンドは、HostGroup01 という名前のホスト グループ オブジェクトを取得し、そのオブジェクトを $HostGroup 変数に格納します。
2 番目のコマンドは、HostGroup01 の過去 3 時間のメモリ使用量データを取得します。
例 2: クラスターのパフォーマンス データを取得する
PS C:\> $Cluster = Get-SCVMHostCluster -Name "Cluster01.Contoso.com"
PS C:\> Get-SCPerformanceData -VMHostCluster $Cluster -PerformanceCounter "MemoryUsage" -Timeframe "Day"
最初のコマンドは、Cluster01 という名前のクラスター オブジェクトを取得し、そのオブジェクトを $Cluster 変数に格納します。
2 番目のコマンドは、Cluster01 の最終日 (24 時間) のメモリ使用量データを取得します。
例 3: 指定したホストのパフォーマンス データを取得する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> Get-SCPerformanceData -VMHost $VMHost -PerformanceCounter "MemoryUsage" -Timeframe "Month"
最初のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、VMHost01 の先月 (30 日間) のメモリ使用量データを gerted します。
例 4: 指定した仮想マシンのパフォーマンス データを取得する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCPerformanceData -VM $VM -PerformanceCounter "MemoryUsage" -Timeframe "Day"
最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
2 番目のコマンドは、VM01 の最終日 (24 時間) のメモリ使用量データを gerted します。
例 5: すべての仮想マシンのパフォーマンス データを取得する
PS C:\> Get-SCPerformanceData -AllVM -PerformanceCounter "CPUUsage"
このコマンドは、すべての仮想マシンの CPU 使用率データを取得します。
パラメーター
-AllVM
すべての仮想マシンのデータが返されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AllVM
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AllVMNetworkGateway
すべてのネットワーク ゲートウェイのデータが返されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AllVMNetworkGateway
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AllVNIC
すべての仮想ネットワーク アダプターのデータが返されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AllVNIC
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PerformanceCounter
使用するパフォーマンス カウンターを指定します。 このパラメーターに使用できる値は次のとおりです。
- CPU使用率
- メモリ使用量
- StorageIOPSUsage
- ネットワークIOUsage
- パワーセービング
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| 指定可能な値: | CPUUsage, MemoryUsage, StorageIOPSUsage, NetworkIOUsage, NetworkIOSent, NetworkIOReceived, PowerSavings |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TimeFrame
パフォーマンス・データを収集する時間枠を指定します。 このパラメーターに使用できる値は次のとおりです。
- 時間
- 一日
- 月
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| 指定可能な値: | Hour, Day, Month |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
VM
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Host
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Cluster
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
HostGroup
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VM
仮想マシン オブジェクトを指定します。
パラメーターのプロパティ
| 型: | VM |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
VM
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMHost
仮想マシンのホストオブジェクトを指定します。 Virtual Machine Manager (VMM) は、Hyper-V ホスト、VMware ESX ホスト、および Citrix XenServer ホストをサポートします。
各種類のホストの詳細については、 Add-SCVMHost コマンドレットを参照してください。
パラメーターのプロパティ
| 型: | Host |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Host
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMHostCluster
VMM ホスト クラスター オブジェクトを指定します。
パラメーターのプロパティ
| 型: | HostCluster |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Cluster
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMHostGroup
仮想マシンのホスト・グループ・オブジェクトを指定します。
パラメーターのプロパティ
| 型: | HostGroup |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
HostGroup
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
パラメーターのプロパティ
| 型: | ServerConnection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
double
このコマンドレットは、double 値の配列を返します。