Collections on Anything About IT

Use PowerShell to find all collections where the specified device has a membership

Tue, 14 Oct 2014 18:44:28 +0000

Yesterday I deployed a computer with ConfigMgr and then wondered why it got certain software installed. And so another script was born.

The Get-CMCollectionOfDevice command retrieves all collections where the specified device has a membership

The Script can be downloaded from here

<#
.SYNOPSIS
 Get-CMCollectionOfDevice retrieves all collections where the specified device has a membership

.DESCRIPTION
 The Get-CMCollectionOfDevice retrieves all collections where the specified device has a membership

.PARAMETER Computer
 The name of the computer device

 Example: Client01

.PARAMETER SiteCode
 The Configuration Manager Site Code

 Example: PRI

.PARAMETER SiteServer
 The computer name of the Configuration Manager Site Server

 Example: Contoso-01

.EXAMPLE
 Get-CMCollectionOfDevice -Computer Client01

 CollectionID Name Commnent LastRefreshTime 
 ------------ ---- -------- --------------- 
 SMS00001 All Systems All Systems 14.10.2014 14:25:57 
 SMSDM003 All Desktop and Server Cli... All Desktop and Server Cli... 14.10.2014 14:30:02 
 PR100011 ALL Contoso Workstation Lim. Limiting collection used f... 14.10.2014 16:37:53 
 PR100014 Zurich Location Zuerich 14.10.2014 14:45:53 

 The above command lists all collections where computer Client01 is a member of. The default
 parameter values for SiteCode and SiteServer defined in the script are used. 

.EXAMPLE
 Get-CMCollectionOfDevice -Computer Client01 -SiteCode PRI -SiteServer Contoso-01
 
 The above command lists all collections where computer Client01 is a member of within the
 Configuration Manager site PRI connecting to Site Server Contoso-01

.NOTES
 Version 1.0 , Alex Verboon
 Credits to Kaido Järvemets and David O'Brien for the code snippets
#>

function Get-CMCollectionOfDevice
{
 [CmdletBinding()]
 [OutputType([int])]
 Param
 (
 # Computername
 [Parameter(Mandatory=$true,
 ValueFromPipelineByPropertyName=$true,
 Position=0)]
 [String]$Computer,

 # ConfigMgr SiteCode
 [Parameter(Mandatory=$false,
 ValueFromPipelineByPropertyName=$true,
 Position=1)]
 [String]$SiteCode = "PRI",

 # ConfigMgr SiteServer
 [Parameter(Mandatory=$false,
 ValueFromPipelineByPropertyName=$true,
 Position=2)]
 [String]$SiteServer = "contoso-01.corp.com"
 )
Begin
{
 [string] $Namespace = "root\SMS\site_$SiteCode"
}

Process
{
 $si=1
 Write-Progress -Activity "Retrieving ResourceID for computer $computer" -Status "Retrieving data" 
 $ResIDQuery = Get-WmiObject -ComputerName $SiteServer -Namespace $Namespace -Class "SMS_R_SYSTEM" -Filter "Name='$Computer'"
 
 If ([string]::IsNullOrEmpty($ResIDQuery))
 {
 Write-Output "System $Computer does not exist in Site $SiteCode"
 }
 Else
 {
 $Collections = (Get-WmiObject -ComputerName $SiteServer -Class sms_fullcollectionmembership -Namespace $Namespace -Filter "ResourceID = '$($ResIDQuery.ResourceId)'")
 $colcount = $Collections.Count
 
 $devicecollections = @()
 ForEach ($res in $collections)
 {
 $colid = $res.CollectionID
 Write-Progress -Activity "Processing $si / $colcount" -Status "Retrieving Collection data" -PercentComplete (($si / $colcount) * 100)

 $collectioninfo = Get-WmiObject -ComputerName $SiteServer -Namespace $Namespace -Class "SMS_Collection" -Filter "CollectionID='$colid'"
 $object = New-Object -TypeName PSObject
 $object | Add-Member -MemberType NoteProperty -Name "CollectionID" -Value $collectioninfo.CollectionID
 $object | Add-Member -MemberType NoteProperty -Name "Name" -Value $collectioninfo.Name
 $object | Add-Member -MemberType NoteProperty -Name "Commnent" -Value $collectioninfo.Comment
 $object | Add-Member -MemberType NoteProperty -Name "LastRefreshTime" -Value ([Management.ManagementDateTimeConverter]::ToDateTime($collectioninfo.LastRefreshTime))
 $devicecollections += $object
 $si++
 }
} # end check system exists
}

End
{
 $devicecollections
}
}

How to identify ConfigMgr collections that take long to refresh

Sat, 30 Aug 2014 09:54:14 +0000

I’ve put together the below PowerShell script this week to identify collections in ConfigMgr that require the longest time to refresh. If you ever experience a decrease in ConfigMgr collection update performance, you might want to run this script to find potential collections that have a long refresh duration.

Function Get-CMCollectionRefreshDuration
{
<#
.Synopsis
 Get-CMCollectionRefreshDuration displays the duration of Configuration Manager refresh cycles
.DESCRIPTION
 Inefficient queries can cause long collection refresh cycles. Use the Get-CMCollectionRefreshDuration
 cmdlet to identify collections with long refresh cycles. 
.EXAMPLE
 Get-CMCollectionRefreshDuration -DataSource sqlsrv01\instance1 -Database CM_DB1

 Collection EvaluationStartTime LastRefreshTime Duration
 ---------- ------------------- --------------- --------
 Collection1 30.08.2014 09:20:11 30.08.2014 09:22:45 00:02:33
 Collection2 30.08.2014 09:27:31 30.08.2014 09:30:05 00:02:33
 Collection3 30.08.2014 07:01:23 30.08.2014 07:03:56 00:02:33
 Collection4 30.08.2014 07:20:38 30.08.2014 07:23:11 00:02:33
 Collection5 30.08.2014 07:05:00 30.08.2014 07:07:33 00:02:33 

.EXAMPLE
 Get-CMCollectionRefreshDuration -DataSource sqlsrv01\instance1 -Database CM_DB1 -ShowTopCollections 100

 Lists the top 100 collections
.PARAMETER DataSource
 The name of the SQL Server that hosts the configuration manager database

 <servername\instance>

.PARAMETER Database
 The database name of the configuration manager database

.PARAMETER ShowTopCollections
 The number of collections to show that have the longers collection refresh cycle duration

#>
 [CmdletBinding()]
 Param
 (
 [Parameter(Mandatory=$false,
 Position=0,
 HelpMessage="Enter the SQL Server datasource name <server\instance>")]
 [string]$DataSource="server01\instance1",
 [Parameter(Mandatory=$false,
 Position=1,
 HelpMessage="The database name of the ConfigMgr database")]
 [string]$Database="CMDB1",
 [Parameter(Mandatory=$false,
 Position=2,
 HelpMessage="The number of top collectons to show")]
 [ValidateRange(1,10000)]
 [int]$ShowTopCollections="5" 
 )

Begin{
 # connecting to SQL server
 Try{
 $Connection = New-Object System.Data.SqlClient.SqlConnection
 $Connection.ConnectionString = "Data Source=$DataSource;Integrated Security=True"
 $Connection.Open()
 }
 Catch [Exception]
 {
 write-output "Unable to connect to $DataSource"
 Write-Output $_.Exception
 Throw
 }
 $query = "
 SELECT TOP $ShowTopCollections
 [CollectionName],
 [EvaluationStartTime],
 [LastRefreshTime],
 CAST([LastRefreshTime] - [EvaluationStartTime] as datetime) as Duration
 FROM [$Database].[dbo].[Collections]
 ORDER BY CAST([LastRefreshTime] - [EvaluationStartTime] as datetime) DESC"

 $command = $connection.CreateCommand()
 $command.CommandText = $query
 $result = $command.ExecuteReader()

 $table = new-object “System.Data.DataTable”
 $table.Load($result)
 $Connection.Close()
}

Process{
 $colupdateduration = @()
 ForEach($cud in $table)
 {
 $object = New-Object -TypeName PSObject
 $object | Add-Member -MemberType NoteProperty -Name "Collection" -Value $cud.Collectionname
 $object | Add-Member -MemberType NoteProperty -Name "EvaluationStartTime" -Value $cud.EvaluationStartTime
 $object | Add-Member -MemberType NoteProperty -Name "LastRefreshTime" -Value $cud.LastRefreshTime
 $object | Add-Member -MemberType NoteProperty -Name "Duration" -Value ($dur = Get-date $cud.Duration -Format "HH:mm:ss")
 $colupdateduration += $object
 }
}

End{
 $colupdateduration
 }
}

Thanks to Roger Zander and Claude Henchoz for the SQL query to find these collections.

PowerShell - Finding ConfigMgr Collections and Members

Wed, 08 Jan 2014 00:42:00 +0000

The below script provides a simple and quick method to find ConfigMgr Collections and its members. The script has a -Name parameter that accepts the exact or part of the collection name. Next all collections that match the name are listed. After selecting a collection, its members are listed.

Function Get-CMColContent()
{
<#
.Synopsis
 Get Configuration Manager Collections and Members
.DESCRIPTION
 This script provides an interactive way to find collections and collection members within 
 Configuration Manager. 
.PARAMETER Name
 The exact or partial collection name. 
.EXAMPLE
 Get-CMColContent -Name All
#>

 Param(
 [Parameter(Mandatory=$true,
 ValueFromPipelineByPropertyName=$true,
 HelpMessage="Enter Collection Name or part of collection Name",
 Position=0)]
 [String]$Name
 )

# Change Site Server Name and Site code so it fits your environment
[string] $SiteServer = "servername"
[string] $SiteCode = "010"
[string] $Namespace = "root\SMS\site_$SiteCode"

$CollectionItem = Get-WmiObject -Namespace $Namespace -ComputerName $SiteServer -Query "SELECT Name,LimitToCollectionName,MemberClassName, MemberCount, CollectionType FROM SMS_Collection WHERE Name LIKE '%$Name%'" | Select-Object Name,LimitToCollectionName,MemberClassName, MemberCount, CollectionType, ResourceID | Sort-Object CollectionType| Out-GridView -Title "Collections" -OutputMode Single

$CollectionType = $CollectionItem.CollectionType
$CollectionName = $CollectionItem.Name
$MemberClassName = $CollectionItem.MemberClassName

If ($CollectionType -eq 2) # Computer collections
 {
 Write-Output "Please wait, this can take a while..."
 $colcontent = Get-WmiObject -Namespace $Namespace -ComputerName $SiteServer -Query "SELECT Name, Active, OperatingSystemNameandVersion, ResourceID FROM SMS_R_SYSTEM where ResourceID in (Select ResourceID from $MemberClassName)" | Select-Object Name, Active, OperatingSystemNameandVersion -wait | Sort-Object Name 
 $colcontent = $colcontent | Out-GridView -Title "Collection: $CollectionName Member Class: $MemberClassName" -OutputMode Multiple
 #return $colcontent
 }
Elseif ($CollectionType -eq 1) # User Collections 
 {
 Write-Output "Please wait, this can take a while..."
 $colcontent = Get-WmiObject -Namespace $Namespace -ComputerName $SiteServer -Query "SELECT UserName, UserPrincipalName, ResourceID FROM SMS_R_USER where ResourceID in (Select ResourceID from $MemberClassName)" | Select-Object Username, UserPrincipalName, ResourceID -wait
 $colcontent = $colcontent | Out-GridView -Title "Collection: $CollectionName Member Class: $MemberClassName" -OutputMode Multiple 
 #return $colcontent
 }
Else
 {
 Write-output "No support for other Collection Type $Collectiontype"
 }

return $colcontent
}

Example:

ConfigMgr 2012 Script for Incremental Collection threshold

Mon, 05 Aug 2013 20:07:46 +0000

As described within the ConfigMgr 2012 Best Practices Wiki on TechNet it’s recommended to keep the number of collections with incremental updates enabled to around 200, this to prevent evaluation delays. So I thought it might be a good idea to keep an eye on collections with incremental updates enabled within our infrastructure using a PowerShell script.

The property RefreshType within the SMS_Collection WMI class defines how Configuration Manager refreshes the collection. According to the documentation on MSDN the property can have the following 3 values.