Get-SCPROTip
Gets PRO tip objects from the VMM database.
Syntax
Get-SCPROTip
[-VMMServer <ServerConnection>]
[<CommonParameters>]Get-SCPROTip
[-VMMServer <ServerConnection>]
-VM <VM>
[<CommonParameters>]Get-SCPROTip
[-VMMServer <ServerConnection>]
-VMHost <Host>
[<CommonParameters>]Get-SCPROTip
[-VMMServer <ServerConnection>]
-Cloud <Cloud>
[<CommonParameters>]Get-SCPROTip
[-VMMServer <ServerConnection>]
-Service <Service>
[<CommonParameters>]Get-SCPROTip
[-VMMServer <ServerConnection>]
[-VMMServerScope]
[<CommonParameters>]Get-SCPROTip
[-VMMServer <ServerConnection>]
-VMHostCluster <HostCluster>
[<CommonParameters>]Get-SCPROTip
[-VMMServer <ServerConnection>]
-PROTipID <Guid>
[<CommonParameters>]Description
The Get-SCPROTip cmdlet gets one or more Performance and Resource Optimization (PRO) tip objects from the Virtual Machine Manager (VMM) database.
If PRO is enabled, a PRO tip recommends an action in response to an alert generated by Operations Manager for hosts that are members of a host group or for hosts configured in a host cluster, as well as for the virtual machines deployed on those hosts. A recommended action might be to move a virtual machine to a new host or to add a CPU to a virtual machine.
PRO provides workload and application-aware resource optimization within host groups or host clusters that are managed by both VMM and Operations Manager. To receive PRO tips for these hosts, you must first configure PRO for VMM. This includes deploying Operations Manager, which generates the PRO tips based on monitors provided by PRO-enabled management packs. PRO tip recommendations are based on policies implemented through Operations Manager.
You can use Get-SCPROTip and the other PROTip cmdlets only on Hyper-V, VMware, or Citrix XenServer hosts that belong to a host group, that are configured in a host cluster, or that belong to a private cloud.
Examples
Example 1: Get all PRO tips for all hosts and all virtual machines managed by VMM
PS C:\> Get-SCPROTipThis command gets all PRO tips from the VMM database and displays information about each PRO tip.
Example 2: Get all active PRO tips for a specific host
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> Get-SCPROTip -VMHost $VMHostThe first command gets the host object named VMHost01 and stores the object in the $VMHost variable.
The second command gets all active PRO tips for VMHost01 and displays information about each tip.
Parameters
-Cloud
Specifies a private cloud object.
| Type: | Cloud |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PROTipID
Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Service
Specifies a VMM service object.
| Type: | Service |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VM
Specifies a virtual machine object.
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMHost
Specifies a virtual machine host object. VMM supports Hyper-V hosts, VMware ESX hosts, and Citrix XenServer hosts.
For more information about each type of host, see the Add-SCVMHost cmdlet.
| Type: | Host |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMHostCluster
Specifies a VMM host cluster object.
| Type: | HostCluster |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Specifies a VMM server object.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServerScope
Indicates that the PRO information returned is scoped to the entire VMM server.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Outputs
PROTip
This cmdlet returns a PROTip object.