Manage System Insights capabilities in Windows Admin Center

You can list all of the available capabilities using the Get-InsightsCapability cmdlet:

1. Open PowerShell. Enter the following command:

Get-InsightsCapability

These capabilities are also visible in System Insights extension:

1. From Windows Admin Center, open Server Manager.
2. Select your server.
3. Select System Insights from the list of extensions.

To enable a capability, use the Enable-InsightsCapability cmdlet:

1. Open PowerShell, and enter the following command replacing the name of the capability with the capability of your choice.

   Enable-InsightsCapability -Name "CPU capacity forecasting"
   

To disable a capability, use the Disable-InsightsCapability cmdlet:

1. Open PowerShell, and enter the following command replacing the name of the capability with the capability of your choice.

   Disable-InsightsCapability -Name "Networking capacity forecasting"
   

2. You're prompted to confirm the capability you're disabling.

   

These settings can be toggled by selecting a capability in Windows Admin Center.

To enable a capability:

1. Open the Systems Insights extension.

2. Select the row of the capability you want to enable.

3. Select Enable in the top menu.

4. The capability is enabled.

   

To disable a capability:

1. Open the Systems Insights extension.

2. Select the name of the capability you want to disable.

3. Select Disable in the top menu of the capability overview page.

4. The capability is disabled.

   

1. Open PowerShell, and enter the following command replacing the name of the capability with the capability of your choice.

   Invoke-InsightsCapability -Name "CPU capacity forecasting"
   

2. Confirm that you want to invoke the capability.

   

1. Open the Systems Insights extension.

2. Select the row of the capability you want to invoke.

3. Select the Invoke button in Windows Admin Center.

   

4. A notification appears and shows the capability was successfully invoked.

Once a capability is invoked, the most recent results are visible using Get-InsightsCapability or Get-InsightsCapabilityResult. These cmdlets output the most recent Status and Status Description of each capability, which describe the result of each prediction. The Status and Status Description fields are further described in the understanding capabilities document.

Additionally, you can use the Get-InsightsCapabilityResult cmdlet to view the last 30 prediction results and to retrieve the data associated with the prediction:

# Specify the History parameter to see the last 30 prediction results.
Get-InsightsCapabilityResult -Name "CPU capacity forecasting" -History

# Use the Output field to locate and then show the results of "CPU capacity forecasting."
# Specify the encoding as UTF8, so that Get-Content correctly parses non-English characters.
$Output = Get-Content (Get-InsightsCapabilityResult -Name "CPU capacity forecasting").Output -Encoding UTF8 | ConvertFrom-Json
$Output.ForecastingResults

The System Insights extension automatically shows the prediction history and parses the results of the JSON result, giving you an intuitive, high-fidelity graph of each forecast:

Use the Get-InsightsCapabilitySchedule cmdlet to see capability schedules. Use the pipeline | in PowerShell to see information for all capabilities returned by the Get-InsightsCapability cmdlet.

Get-InsightsCapability | Get-InsightsCapabilitySchedule

Periodic predictions are enabled by default though they can be disabled at any time using the Enable-InsightsCapabilitySchedule and Disable-InsightsCapabilitySchedule cmdlets:

Enable-InsightsCapabilitySchedule -Name "Total storage consumption forecasting"
Disable-InsightsCapabilitySchedule -Name "Volume consumption forecasting"

You can create custom schedules for each capability using the Set-InsightsCapabilitySchedule cmdlet:

Set-InsightsCapabilitySchedule -Name "CPU capacity forecasting" -Daily -DaysInterval 2 -At 4:00PM
Set-InsightsCapabilitySchedule -Name "Networking capacity forecasting" -Daily -DaysOfWeek Saturday, Sunday -At 2:30AM
Set-InsightsCapabilitySchedule -Name "Total storage consumption forecasting" -Hourly -HoursInterval 2 -DaysOfWeek Monday, Wednesday, Friday
Set-InsightsCapabilitySchedule -Name "Volume consumption forecasting" -Minute -MinutesInterval 30

Because the default capabilities analyze daily data, it's recommended to use daily schedules for these capabilities. Learn more about the default capabilities.

You can also use Windows Admin Center to view and set schedules for each capability.

1. Select the name of the capability you want to schedule.
2. Select Settings on the capability overview page.
3. The Schedule tab shows the current schedule, and can be updated to run on a different schedule.

You can see the actions for each capability using the Get-InsightsCapabilityAction cmdlet:

Get-InsightsCapability | Get-InsightsCapabilityAction

You can create new actions or delete existing actions using the Set-InsightsCapabilityAction and Remove-InsightsCapabilityAction cmdlets. Each action is run using credentials that are specified in the ActionCredential parameter.

$Cred = Get-Credential
Set-InsightsCapabilityAction -Name "CPU capacity forecasting" -Type Warning -Action "C:\Users\Public\WarningScript.ps1" -ActionCredential $Cred
Set-InsightsCapabilityAction -Name "CPU capacity forecasting" -Type Critical -Action "C:\Users\Public\CriticalScript.ps1" -ActionCredential $Cred

Remove-InsightsCapabilityAction -Name "CPU capacity forecasting" -Type Warning

You can also use Windows Admin Center to set remediation actions.

1. Select the name of the capability you want to specify actions for.
2. Select Settings on the capability overview page.
3. The Actions tab shows the current actions. Browse example scripts, set scripts to run for each status, and enter credentials in this tab.