Somewhat quick and dirty, but I’m sure it’ll be of use to anyone doing a larger scale rollout of distribution points.<\/p>\n
The following script can interactively roll out distribution points for you, saving a huge amount of clicking around in the SCCM console. The code can easily be adapted to run everything from functions and bulk import a list of distribution points from CSV to SCCM.<\/p>\n
#Add distribution point with State Migration and Pulse Rate limitation and scheduling
\n#Author: Jos Lieben, OGD
\n#Copyright: Free to Use and Distribute
\n#Credits: David O\u2019Brien (david-obrien.net) for WMI class interaction
\n#notice: you must have the required console updates for some of these commands to work with SCCM 2012 SP1<\/p>\n
####GENERAL CONFIGURATION####
\n#If you clear any config, the script will prompt you for it, config simply helps you simplify deployments if for example, you only have one site
\n#Path to your PSD files
\nImport-Module \u201cC:\\Program Files (x86)\\Microsoft Configuration Manager\\AdminConsole\\bin\\ConfigurationManager.psd1\u2033
\n#Your site code
\n$site_code = \u201cEU1\u2033
\n#Name of your distribution point (Fully Qualified Name required!)
\n$server_name = \u201c\u201d
\n#Drive letter for your primary content library, use Automatic if you wish SCCM to manage this for you
\n$driveletter_plibrary = \u201c\u201d
\n#Drive letter for your primary content share, use Automatic if you wish SCCM to manage this for you
\n$driveletter_pshare = \u201c\u201d
\n#If you wish to add a state migration point to the DP, set this to $true
\n$add_statemigrationpoint = $false
\n#Path to data on the state migration point
\n$state_migrationpoint_localpath = \u201c\u201d
\n#Distribution Point Group Membership can be configured with this variable
\n$distributionpointgroup = \u201c\u201d
\n####END OF GENERAL CONFIGURATION####
\n####SCHEDULING CONFIGURATION####
\n#Set to False if you do not wish to configure transfer schedules for your DP ($false recommended)
\n$add_schedule = $true
\n#size of each block sent, leave at 0 to prompt, only used when add_schedule=$true
\n$block_size = 0
\n#delay between each block sent, leave at 0 to prompt, only used when add_schedule=$true
\n$block_delay = 0
\n#Array containing 24 elements, one for each hour of the day. This property specifies the type of usage for each hour.
\n# 1 means all Priorities, 2 means all but low, 3 is high only, 4 means none
\n#this example allows only high priority sendings from monday till friday between 8AM and 8PM and everything outside that timeframe
\n$HourUsageScheduleWeekdays = @(1,1,1,1,1,1,1,1,3,3,3,3,3,3,3,3,3,3,3,3,1,1,1,1)
\n$HourUsageScheduleWeekend = @(1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1)
\n####END OF SCHEDULING CONFIGURATION#####
\n#standard variables
\n$ja = new-Object System.Management.Automation.Host.ChoiceDescription \u201c&Yes\u201d,\u201dhelp\u201d
\n$nee = new-Object System.Management.Automation.Host.ChoiceDescription \u201c&No\u201d,\u201dhelp\u201d<\/p>\n
Clear-Host
\nif($site_name -eq \u201c\u201d) {
\n$site_code = Read-Host \u201cEnter your site code (for example: EU1)\u201d
\n}
\nif($server_name -eq \u201c\u201d) {
\n$server_name = Read-Host \u201cEnter the FQDN of your new distribution point (for example: dp01.ogd.local)\u201d
\n}
\nif($driveletter_plibrary -eq \u201c\u201d) {
\n$driveletter_plibrary = Read-Host \u201cEnter the driveletter for the primary content library (for example: E)\u201d
\n}
\nif($driveletter_pshare -eq \u201c\u201d) {
\n$driveletter_pshare = Read-Host \u201cEnter the driveletter for the primary content share (for example: E)\u201d
\n}
\nif($add_statemigrationpoint -eq $true -And $state_migrationpoint_localpath -eq \u201c\u201d){
\n$state_migrationpoint_localpath = Read-Host \u201cEnter the path your state migration point should use to store data (use quotes, for example: \u201cC:\\USMT\u201d)\u201d
\n}
\nif($distributionpointgroup -eq \u201c\u201d) {
\n$distributionpointgroup = Read-Host \u201cEnter the name of the group you wish your distribution point to be a member of (for example OGD Production Site)\u201d
\n}
\nif($add_schedule -eq $true){
\nif($block_size -eq 0){
\n$block_size = Read-Host(\u201cSpecify the maximum block size in KB for the Pulse Rate (min 1, max 256)\u201d)
\n}
\nif($block_delay -eq 0){
\n$block_delay = Read-Host(\u201cSpecify the delay between blocks (min 1, max 30)\u201d)
\n}
\nif([int]$block_delay -gt 30) {[int]$block_delay = 30}
\nif([int]$block_delay -lt 1) {[int]$block_delay = 1}
\nif([int]$block_size -gt 256) {[int]$block_size = 256}
\nif([int]$block_size -lt 1) {[int]$block_size = 1}
\n}<\/p>\n
#bind to correct site
\nSet-Location $site_code\u201d:\u201d
\n#summarize
\nWrite-Host \u201c\u201d
\nWrite-Host \u201c\u201d
\nWrite-Host \u201cWe have enough information to proceed, the following will take place:\u201d
\nWrite-Host \u201d * A distribution point will be added to site $site_code\u201d
\nWrite-Host \u201d * The FQDN is $server_name\u201d
\nWrite-Host \u201d * A Content Library will be placed on drive $driveletter_plibrary\u201d
\nWrite-Host \u201d * A Content Share will be placed on drive $driveletter_pshare\u201d
\nWrite-Host \u201d * The DP will be added to the $distributionpointgroup group\u201d
\nif($add_statemigrationpoint -eq $true){
\nWrite-Host \u201d * A state migration point will be added\u201d
\nWrite-Host \u201d * State Migration Point Storage Path: $state_migrationpoint_localpath\u201d
\n$folders = New-CMStorageFolder -StorageFolderName $state_migrationpoint_localpath -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte
\n}else{
\nWrite-Host \u201d * A state migration point will NOT be added\u201d
\n}
\nif($add_schedule -eq $true){
\nWrite-Host \u201d * Rate Limitation will be set to $block_size KB per $block_delay seconds according to schedule in config\u201d
\n}else{
\nWrite-Host \u201d * Rate Limitation will NOT be configured\u201d
\n}<\/p>\n
Write-Host \u201c\u201d
\n$options = [System.Management.Automation.Host.ChoiceDescription[]]($ja,$nee)
\n$prompt = $host.ui.PromptForChoice(\u201c\u201d,\u201dDo you wish to proceed?\u201d,$options,0)
\nWrite-Host \u201c\u201d
\nif($prompt -eq 1) {
\nWrite-Host \u201cCancelled\u2026\u201d
\nExit
\n}<\/p>\n
new-CMSiteSystemServer -ServerName $server_name -SiteCode $site_code<\/p>\n
add-CMdistributionpoint -SiteSystemServerName $server_name -SiteCode $site_code -CertificateExpirationTimeUtc \u201cMonday, January 2, 2017 1:00:00 AM\u201d -MinimumFreeSpaceMB 5000 -InstallInternetServer -PrimaryContentLibraryLocation $driveletter_plibrary -PrimaryPackageShareLocation $driveletter_pshare -EnablePxeSupport -AllowRespondIncomingPxeRequest -EnableUnknownComputerSupport<\/p>\n
add-CMDistributionPointToGroup -DistributionPointName $server_name -DistributionPointGroupName $distributionpointgroup
\nif($add_statemigrationpoint -eq $true){
\nadd-cmstatemigrationpoint -EnableRestoreOnlyMode $false -sitesystemservername $server_name -sitecode $site_code -storagefolders $folders -TimeDeleteAfter 7 -TimeUnit Days -AllowFallBackSourceLocationForContent $false
\n}<\/p>\n
if($add_schedule -eq $true){<\/p>\n
$Percent = 100
\n$UsageAsBackup = @($true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true,$true)<\/p>\n
$RateLimitingSchedule = @($Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent,$Percent)<\/p>\n
$SMS_SCI_ADDRESS = \u201cSMS_SCI_ADDRESS\u201d
\n$class_SMS_SCI_ADDRESS = [wmiclass]\u201d\u201d
\n$class_SMS_SCI_ADDRESS.psbase.Path =\u201dROOT\\SMS\\Site_$($site_code):$($SMS_SCI_ADDRESS)\u201d<\/p>\n
$SMS_SCI_ADDRESS = $class_SMS_SCI_ADDRESS.CreateInstance()
\n# Set the UsageSchedule For Weekdays
\n$SMS_SiteControlDaySchedule = \u201cSMS_SiteControlDaySchedule\u201d
\n$SMS_SiteControlDaySchedule_class = [wmiclass]\u201d\u201d
\n$SMS_SiteControlDaySchedule_class.psbase.Path = \u201cROOT\\SMS\\Site_$($site_code):$($SMS_SiteControlDaySchedule)\u201d
\n$SMS_SiteControlDaySchedule = $SMS_SiteControlDaySchedule_class.createInstance()
\n$SMS_SiteControlDaySchedule.Backup = $UsageAsBackup
\n$SMS_SiteControlDaySchedule.HourUsage = $HourUsageScheduleWeekdays
\n$SMS_SiteControlDaySchedule.Update = $true<\/p>\n
# Set the UsageSchedule For Weekend
\n$SMS_SiteControlDayScheduleWeekend = \u201cSMS_SiteControlDaySchedule\u201d
\n$SMS_SiteControlDayScheduleWeekend_class = [wmiclass]\u201d\u201d
\n$SMS_SiteControlDayScheduleWeekend_class.psbase.Path = \u201cROOT\\SMS\\Site_$($site_code):$($SMS_SiteControlDayScheduleWeekend)\u201d
\n$SMS_SiteControlDayScheduleWeekend = $SMS_SiteControlDayScheduleWeekend_class.createInstance()
\n$SMS_SiteControlDayScheduleWeekend.Backup = $UsageAsBackup
\n$SMS_SiteControlDayScheduleWeekend.HourUsage = $HourUsageScheduleWeekend
\n$SMS_SiteControlDayScheduleWeekend.Update = $true<\/p>\n
$SMS_SCI_ADDRESS.UsageSchedule = @($SMS_SiteControlDayScheduleWeekend,$SMS_SiteControlDaySchedule,$SMS_SiteControlDaySchedule,$SMS_SiteControlDaySchedule,$SMS_SiteControlDaySchedule,$SMS_SiteControlDaySchedule,$SMS_SiteControlDayScheduleWeekend)<\/p>\n
$SMS_SCI_ADDRESS.RateLimitingSchedule = $RateLimitingSchedule<\/p>\n
$SMS_SCI_ADDRESS.AddressPriorityOrder = \u201c0\u201d
\n$SMS_SCI_ADDRESS.AddressType = \u201cMS_LAN\u201d
\n$SMS_SCI_ADDRESS.DesSiteCode = \u201c$($server_name)\u201d
\n$SMS_SCI_ADDRESS.DestinationType = \u201c1\u201d
\n$SMS_SCI_ADDRESS.SiteCode = \u201c$($site_code)\u201d
\n$SMS_SCI_ADDRESS.UnlimitedRateForAll = $false<\/p>\n
# Set the embedded Properties
\n$embeddedpropertyList = $null
\n$embeddedproperty_class = [wmiclass]\u201d\u201d
\n$embeddedproperty_class.psbase.Path = \u201cROOT\\SMS\\Site_$($site_code):SMS_EmbeddedPropertyList\u201d
\n$embeddedpropertyList = $embeddedproperty_class.createInstance()
\n$embeddedpropertyList.PropertyListName = \u201cPulse Mode\u201d
\n$embeddedpropertyList.Values = @(1,$block_size,$block_delay) #second value is size of data block in KB, third is delay between data blocks in seconds<\/p>\n
$SMS_SCI_ADDRESS.PropLists += $embeddedpropertyList<\/p>\n
$embeddedproperty = $null
\n$embeddedproperty_class = [wmiclass]\u201d\u201d
\n$embeddedproperty_class.psbase.Path = \u201cROOT\\SMS\\Site_$($site_code):SMS_EmbeddedProperty\u201d
\n$embeddedproperty = $embeddedproperty_class.createInstance()
\n$embeddedproperty.PropertyName = \u201cConnection Point\u201d
\n$embeddedproperty.Value = \u201c0\u201d
\n$embeddedproperty.Value1 = \u201c$($server_name)\u201d
\n$embeddedproperty.Value2 = \u201cSMS_DP$\u201d
\n$SMS_SCI_ADDRESS.Props += $embeddedproperty<\/p>\n
$embeddedproperty = $null
\n$embeddedproperty_class = [wmiclass]\u201d\u201d
\n$embeddedproperty_class.psbase.Path = \u201cROOT\\SMS\\Site_$($site_code):SMS_EmbeddedProperty\u201d
\n$embeddedproperty = $embeddedproperty_class.createInstance()
\n$embeddedproperty.PropertyName = \u201cLAN Login\u201d
\n$embeddedproperty.Value = \u201c0\u201d
\n$embeddedproperty.Value1 = \u201c\u201d
\n$embeddedproperty.Value2 = \u201c\u201d
\n$SMS_SCI_ADDRESS.Props += $embeddedproperty<\/p>\n
$SMS_SCI_ADDRESS.Put() | Out-Null
\n}
\n#In case your executionpolicy is restricted and you can\u2019t modify it, paste these lines before calling the script
\n#Copyright Oisin Grehan
\n#START (remove #\u2019s)
\n#function Disable-ExecutionPolicy {
\n#($ctx = $executioncontext.gettype().getfield(\u201c_context\u201d,\u201dnonpublic,instance\u201d).getvalue($executioncontext)).gettype().getfield(\u201c_authorizationManager\u201d,\u201dnonpublic,instance\u201d).setvalue($ctx, (new-object System.Management.Automation.AuthorizationManager \u201cMicrosoft.PowerShell\u201d))
\n#}
\n#Disable-ExecutionPolicy
\n#END<\/p>\n","protected":false},"excerpt":{"rendered":"
Somewhat quick and dirty, but I’m sure it’ll be of use to anyone doing a larger scale rollout of distribution points. The following script can interactively roll out distribution points for you, saving a huge amount of clicking around in the SCCM console. The code can easily be adapted to run everything from functions and … Continue reading Scripted Deployment of Distribution Points in SCCM 2012 including rate scheduling<\/span>