Get-SCPROTip

Get-SCPROTip

Gets PRO tip objects from the VMM database.

Syntax

Parameter Set: AllTips
Get-SCPROTip [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: CloudTips
Get-SCPROTip -Cloud <Cloud> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: ClusterTips
Get-SCPROTip -VMHostCluster <HostCluster> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: GetById
Get-SCPROTip -PROTipID <Guid]> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: HostTips
Get-SCPROTip -VMHost <Host> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: ServiceTips
Get-SCPROTip -Service <Service> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: VMMServerTips
Get-SCPROTip -VMMServerScope [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: VMTips
Get-SCPROTip -VM <VM> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed 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.

Parameters

-Cloud<Cloud>

Specifies a private cloud object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Service<Service>

Specifies a VMM service object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VM<VM>

Specifies a virtual machine object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMHost<Host>

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, type Get-Help Add-SCVMHost -detailed. See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMHostCluster<HostCluster>

Specifies a VMM host cluster object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

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.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • PROTip

Examples

Example 1: Get all PRO tips for all hosts and all virtual machines managed by VMM

This command gets all PRO tips from the VMM database and displays information about each PRO tip.

PS C:\> Get-SCPROTip

Example 2: Get all active PRO tips for a specific host

The first command gets the host object named VMHost01, and then stores the object in the $VMHost variable.

The second command gets all active PRO tips for VMHost01 and displays information about each tip.

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> Get-SCPROTip -VMHost $VMHost

Add-SCVMHost

Clear-SCPROTip

Invoke-SCPROTip

Set-SCPROTip

Test-SCPROTip

Get-SCVMHost