Create-Collections - V 2.0.0.0

By -
This script creates SCCM Device Collections. There are parameters to create a single Device Collection, Collections from a list in a file or Collections corresponding to the Active Directory OUs in AD. When you run he scrip if you do not specify the Site Server, Site Code Limiting Collection or refresh Schedule for the Collections you will be asked to provide the information. The script supports refresh schedules for Weeks, Days, Hours, Minuets and Continuous. Depending on your refresh schedule type you will be asked for the time between each refresh. You can also add other Collections to the membership roles for the collections you are creating, The parameter is a filter so you can do things like add all Collections that start with Install. I will be working to add more membership rules to the script but that is what I have for now

Since my previous version of this script I have Changed the following
  • Added AD OU Support
  • Added a check that that Collection was created 
  • Added the ability to add other Collection Membership Rules to the Collections you are creating







<#
.SYNOPSIS
Creates a SCCM Device Collections

.DESCRIPTION
Creates SCCM Device Collections from a single Collection name, a list of names in a text file or from a group of Active Directory OUs

.PARAMETER CollectionName
If createding only a single Collection use this parameter to specify the name of the Collection

.PARAMETER CollectionsFile
Use this parameter to specify a list of Collection names to create, must be full file path

.PARAMETER LimitingCollection
The Collection you want to limmit the collection members from

.PARAMETER LoadLocal
When used will load the Powershell Module from the local system rather then the Site Server

.PARAMETER SiteServer
Sets the SCCM Site Server

.PARAMETER SiteCode
Sets the SCCM Site Code

.PARAMETER ColletionsByOUs
Create Collctions based on Active Directory organizationl Units members
use the ou destinquised name 
you must have remote server adminsitration tools installed for this parameter to work

.PARAMETER ScheduleType
Weeks - Sets the Collection to update every x weeks on a spesific days of the week
Days - Sets the Collection to update every x days
Hours - Sets the Collection to update every x Hours
Minutes - Sets the Collection to update every x Minutes
Continuous - Sets the Collection to update Incrementally

.PARAMETER AddCollections
Allows you to add a member collections to the collection you are created

.EXAMPLE
Create-Collection.ps1 -SiteServer SCCM-1 -SiteCode MSN -CollctionName "Testing Collection" -LimmitingCollection "All Desktops" -ScheduleType "Hours"
Creates a Collection Named Testing Collection with a limmiting Collection of All Desktops that will refresh hourly. 

.EXAMPLE
Create-Collection.ps1 -CollectionsByOUs "OU=Europe,CN=Users,DC=corp,DC=contoso,DC=com"
Create a Collection for each OU in the Europe OU

.Example 
Create-Collelctions.ps1 -CollectionsFile List.txt -ScheduleType "Hours" -AddCollections "Install*"
Each collection listed in List.txt will be created with a refesh schedule for hours and will have all Collections that start with Install added to them

.NOTES
Created By: Kris Gross
Email: KrisGross@sccmtst.com
Twitter: @kmgamd
Version: 2.0.0.0

.LINK
http://sccmtst.com
#>

Param(  
        #Create Collection From Settings
        $CollectionName,
        $CollectionsFile,
        $CollectionsByOUs,
        #SCCM Moduel Settings
        [switch]$LoadLocal,
        [Parameter(Mandatory=$True)]
        $SiteServer,
        [Parameter(Mandatory=$True)]
        $SiteCode,
        #Collection Settings
        [Parameter(Mandatory=$True)]
        $LimitingCollection,
        [Parameter(Mandatory=$True)]
        [ValidateSet('Weeks','Days','Hours','Minutes','Continuous')]
        [string]$ScheduleType,
        [string]$AddCollections
        )

#checks if the script should load the local PowerShell Module
if ($LoadLocal -eq "$True") 
{
    Set-Location 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\'
    Import-Module .\ConfigurationManager.psd1 -verbose:$false   
}
else 
{
    Import-Module \\$SiteServer\SMS_$SiteCode\AdminConsole\bin\ConfigurationManager.psd1 -verbose:$false
}

#Sets the loacation to the SCCM Site so the script can run
$site = $SiteCode + ":"
Set-Location $site

#Sets the Schedule based on the ScheduleType parameter
If ($Scheduletype -eq "Hours") 
{   
    $Hours = Read-Host "How many hours between refresh"
    $Schedule = New-CMSchedule -RecurInterval Hours -RecurCount $Hours
}

If ($Scheduletype -eq "Days") 
{   
    $Days = Read-Host "How many days between refresh"
    $Schedule = New-CMSchedule -RecurInterval Days -RecurCount $Days
}

If ($Scheduletype -eq "Weeks") 
{   
    $DayOfWeek = Read-Host "Day of the week for reshresh"
    $WeeksBetween = Read-Host "Number of weeks between refresh"
    $Schedule = New-CMSchedule -Start "01/01/2014 9:00 PM" -DayOfWeek $DayOfWeek -RecurCount $WeeksBetween
}

If ($Scheduletype -eq "Minutes") 
{   
    $Minutes = Read-Host "How many minutes between refresh"
    $Schedule = New-CMSchedule -RecurInterval Minutes -RecurCount $Minutes
}

#Create a Collection based on a list in a file
If ($CollectionsFile)
{
    $CollectionsFromFile = Get-Content "$CollectionsFile"
    If ($ScheduleType -eq "Continuous")
    {
        If($AddCollections){$CollectionFilter = (Get-CMDeviceCollection | Where-Object Name -Like "$AddCollections").name}
        Foreach ($Collection in ($CollectionsFromFile))
        {
            New-CmDeviceCollection -Name "$Collection" -LimitingCollectionName "$LimitingCollection" -RefreshType Continuous -ErrorAction SilentlyContinue | Out-Null
            If($AddCollections)
            {
                ForEach ($CollectionToAdd in ($CollectionFilter))
                {
                    Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "$Collection" -IncludeCollectionName "$CollectionToAdd" -ErrorAction SilentlyContinue | Out-Null
                }
            }
            If (!(Get-CMCollection -name "$Collection"))
            {
                Write-Error "$Collection Not Created" 
            }
            IF (Get-CMCollection -name "$Collection")
            {
                write-Host "$Collection Created"
            }
        }
    }
    else 
    {
        If($AddCollections){$CollectionFilter = (Get-CMDeviceCollection | Where-Object Name -Like "$AddCollections").name}
        Foreach ($Collection in ($CollectionsFromFile))
        {
            New-CmDeviceCollection -Name "$Collection" -LimitingCollectionName "$LimitingCollection" -RefreshSchedule $Schedule -ErrorAction SilentlyContinue | Out-Null
            If($AddCollections)
            {
                ForEach ($CollectionToAdd in ($CollectionFilter))
                {
                    Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "$Collection" -IncludeCollectionName "$CollectionToAdd" -ErrorAction SilentlyContinue | Out-Null
                }
            }
            If (!(Get-CMCollection -name "$Collection"))
            {
                Write-Error "$Collection Not Created" 
            }
            IF (Get-CMCollection -name "$Collection")
            {
                write-Host "$Collection Created"
            }
        }
    }
}

#If only a name is specified will only create a single collection
IF ($CollectionName)
{
    If ($ScheduleType -eq "Continuous") 
    {
        If($AddCollections){$CollectionFilter = (Get-CMDeviceCollection | Where-Object Name -Like "$AddCollections").name}
        New-CmDeviceCollection -Name "$CollectionName" -LimitingCollectionName "$LimitingCollection" -RefreshType Continuous -ErrorAction SilentlyContinue | Out-Null
        If($AddCollections)
        {
            ForEach ($CollectionToAdd in ($CollectionFilter))
            {
                Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "$CollectionName" -IncludeCollectionName "$CollectionToAdd" -ErrorAction SilentlyContinue | Out-Null
            }
        }
        If (!(Get-CMCollection -name "$CollectionName"))
        {
            Write-Error "$CollectionName Not Created" 
        }
        IF (Get-CMCollection -name "$CollectionName")
        {
            write-Host "$CollectionName Created"
        }
    }       
    else 
    {
        If($AddCollections){$CollectionFilter = (Get-CMDeviceCollection | Where-Object Name -Like "$AddCollections").name}
        New-CmDeviceCollection -Name "$CollectionName" -LimitingCollectionName "$LimitingCollection" -RefreshSchedule $Schedule -ErrorAction SilentlyContinue | Out-Null
        If($AddCollections)
        {
            ForEach ($CollectionToAdd in ($CollectionFilter))
            {
                Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "$CollectionName" -IncludeCollectionName "$CollectionToAdd" -ErrorAction SilentlyContinue | Out-Null
            }
        }
        If (!(Get-CMCollection -name "$CollectionName"))
        {
            Write-Error "$CollectionName Not Created" 
        }
        IF (Get-CMCollection -name "$CollectionName")
        {
            write-Host "$CollectionName Created"
        }
    }
}

#Creates the Collections based on AD OU members
If ($CollectionsByOUs)
{
    #gets the OUs in a OU
    $OUs = (Get-ADOrganizationalUnit -Filter * -SearchBase $CollectionsByOUs -SearchScope subtree).Name
    If ($ScheduleType -eq "Continuous")
    {
        If($AddCollections){$CollectionFilter = (Get-CMDeviceCollection | Where-Object Name -Like "$AddCollections").name}
        Foreach ($OU in $OUS)
        {
            New-CmDeviceCollection -Name "$OU" -LimitingCollectionName "$LimitingCollection" -RefreshType Continuous -ErrorAction SilentlyContinue | Out-Null
            If($AddCollections)
            {
                ForEach ($CollectionToAdd in ($CollectionFilter))
                {
                    Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "$OU" -IncludeCollectionName "$CollectionToAdd" -ErrorAction SilentlyContinue | Out-Null
                }
            }
            If (!(Get-CMCollection -name "$OU"))
            {
                Write-Error "$OU Not Created" 
            }
            IF (Get-CMCollection -name "$OU")
            {
                write-Host "$OU Created"
            }
        }
    }
    Else
    {
        If($AddCollections){$CollectionFilter = (Get-CMDeviceCollection | Where-Object Name -Like "$AddCollections").name}
        Foreach ($OU in $OUS)
        {
            New-CmDeviceCollection -Name "$OU" -LimitingCollectionName "$LimitingCollection" -RefreshSchedule $Schedule -ErrorAction SilentlyContinue | Out-Null
            If($AddCollections)
            {
                ForEach ($CollectionToAdd in ($CollectionFilter))
                {
                    Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "$OU" -IncludeCollectionName "$CollectionToAdd" -ErrorAction SilentlyContinue | Out-Null
                }
            }
            If (!(Get-CMCollection -name "$OU"))
            {
                Write-Error "$OU Not Created" 
            }
            IF (Get-CMCollection -name "$OU")
            {
                write-Host "$OU Created"
            }
        }
    }
}

#Changes the location back to where the script was ran from
Set-Location $PSScriptRoot

Popular posts from this blog

SCCM Task Sequence GUI - How to set up the TS to work with a GUI

By -
Image
Before I have posted how you can create a TS for windows 10 , add a GUI to your TS and run a script to configure your windows 10 install . However all of this has become out dated and so I wanted to update all of that. This how to will walk you through how to create a TS that will allow you to choose a windows 10 or windows 7 image, name the computer, add the computer description to AD, Choose form a list what applications you want to install, Choose to enable BitLocker and set the PIN as well as create a local account. Prerequisites: MDT integrated to SCCM A boot image with the following components added Windows Powershell(WinPE-DismCmdlest) HTML(WinPE-HTA) Microsoft .NET (WinPE-NetFx) Windows Powershell (WinPE-Powershell) A windows 10 and windows 7 image  1. Download the package I have put together containing the scripts you will need https://github.com/sccmtst/SCCM-Management-Scripts/tree/master/TSGUI 2. If you have not already done so download and in...
Read more

SCCM Applications vs. SCCM Packages: Understanding the Key Differences

By -
Microsoft System Center Configuration Manager (SCCM) is a versatile and powerful tool for managing devices, applications, and updates in an organization's IT environment. Among its many features, SCCM allows you to deploy software to your end-users in two primary ways: Applications and Packages. Although both methods have a similar goal, they have some key differences that IT administrators should understand when choosing the appropriate deployment method. In this blog post, we will explore these differences and help you decide which option is best for your organization. Definition and Deployment Scenarios SCCM Applications: An SCCM Application is a high-level, user-centric deployment method that focuses on providing the desired user experience. Applications are designed to be state-based, meaning they can detect if the application is already installed and only perform the necessary actions if the application is not present or if a newer version is available. Applications are suita...
Read more

Faster PXE boot times in SCCM 1606 and later

By -
Image
A new feature introduced with SCCM 1606 was being able to modify the boot times for PXE. This is done by modifying the TFTP block and window size of the boot image RamDisk. This was originally implemented to help a admin over come network requirement. This allows us to make the PXE boot times much faster for my self this meant taking a 10 minute boot time all the way down to 30 second boot time. In order to make this change you need to create 2 registry keys on your PXE enabled DP. Location : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP Name: RamDiskTFTPWindowSize Type : REG_DWORD Value : <customized window size> The default value is 1 (1 data block fills the window)  Location : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP Name: RamDiskTFTPBlockSize Type : REG_DWORD Value : <customized block size> The default value is 4096 (4k).  once you have added the registry keys you will need to restart  the Windows Deployment Service for the ch...
Read more