Get-SCPROTip

Gets PRO tip objects from the VMM database.

Syntax

Get-SCPROTip -Cloud <Cloud> [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCPROTip -PROTipID <Guid> [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCPROTip -Service <Service> [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCPROTip -VM <VM> [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCPROTip -VMHost <Host> [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCPROTip -VMHostCluster <HostCluster> [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCPROTip [-VMMServer <ServerConnection>] [-VMMServerScope] [<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-SCPROTip

This 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 $VMHost

The 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
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
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
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Service

Specifies a VMM service object.

Type:Service
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VM

Specifies a virtual machine object.

Type:VM
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
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
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VMHostCluster

Specifies a VMM host cluster object.

Type:HostCluster
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VMMServerScope

Indicates that the PRO information returned is scoped to the entire VMM server.

Type:SwitchParameter
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

PROTip

This cmdlet returns a **PROTip** object.