Edit

Get-CMCollectionEvaluationStatus

  • Reference
Module:
ConfigurationManager

Get the status of collection evaluation.

Syntax

Get-CMCollectionEvaluationStatus
   [-IsMemberChanged <Boolean>]
   -EvaluationTypeOption <EvaluationType>
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionEvaluationStatus
   [-IsMemberChanged <Boolean>]
   -EvaluationTypeOption <EvaluationType>
   [-Id] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionEvaluationStatus
   [-IsMemberChanged <Boolean>]
   -EvaluationTypeOption <EvaluationType>
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Get the status of collection evaluation. For more information, see How to view collection evaluation.

Tip

The collection evaluation process happens on primary sites, not on the central administration site (CAS). Use this cmdlet when connected to a primary site.

Examples

Example 1: Show status for collections with long full evaluation

This example first uses Get-CMCollectionEvaluationStatus to get the status of full evaluation for all collections. It then uses the Where-Object cmdlet to filter the results to the collections where the full evaluation time was greater than five seconds (5000 milliseconds).

Get-CMCollectionEvaluationStatus -EvaluationTypeOption Full | Where-Object Length -gt 5000

Example 2: Show summary of full evaluation on built-in collections that recently changed

This example first uses the Get-CMCollection cmdlet to get all collections whose name starts with All. The results of this query will include all built-in collections such as All Systems and All Users. It then passes those results to the Get-CMCollectionEvaluationStatus cmdlet to get their full evaluation status, only if they had any recent member changes. It then uses the Select-Object cmdlet to only display the name of the collection, how many milliseconds full evaluation took, and how many members changed. By default, the output displays as a table.

Get-CMCollection -Name "All*" | Get-CMCollectionEvaluationStatus -EvaluationTypeOption Full -IsMemberChanged $True | Select-Object CollectionName, Length, MemberChanges

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EvaluationTypeOption

Specify the type of evaluation for which to get the status, either Full or Incremental. For more information, see Collection evaluation in Configuration Manager.

Type:EvaluationType
Accepted values:Full, Incremental
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Specify the ID of a collection to query. For example, "SMS00002".

Type:String
Aliases:CollectionId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specify a collection object to query. To get this object, use the Get-CMCollection cmdlet.

Type:IResultObject
Aliases:Collection
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IsMemberChanged

Set this parameter to $true to filter the results to collections whose membership recently changed. In other words, where the MemberChanges attribute isn't 0.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specify the name of a collection to query. For example, "All Users".

Type:String
Aliases:CollectionName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject[]

IResultObject

IResultObject[]

IResultObject