SCCM: PowerShell Skript, um fehlende Packages für Tasksequenzen ausfindig zu machen
In unserer produktiven SCCM-Umgebung werden insbesondere die größeren Content-Pakete per Prestaging und USB-Datenträger verteilt. Dabei kann es vorkommen, das man den Überblick, welches Paket noch auf welchem Distribution-Point fehlt bzw. für welche Tasksequenzen wo noch Pakete fehlen, verloren geht.
Um dieses Problem zu lösen, habe ich ein PowerShell-Skript geschrieben. Dazu habe ich mich von Inhalten von Jason Scheffelmaer inspirieren lassen. Um das Skript nutzen zu können, benötigt man die SCCM.psm1 von Michael Niehaus.
Das Skript wird ohne Parameter aufgerufen und fragt alle notwendigen Werte bei der Abarbeitung ab. Wichtig ist, dass die x86-Variante der PowerShell verwendet wird. Im Skript selber muss noch der Pfad zur SCCM.psm1 angepasst werden.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 | # Get-SCCMMissingTSPackages.ps1 # Author: Haiko Hertes # Parts of the Script are taken from CheckTSPrompt.ps1 from Jason Scheffelmaer # Needs sccm.psm1 from Michael Niehaus, tested with Version 1.5 # ------------- DISCLAIMER ------------------------------------------------- # This script code is provided as is with no guarantee or waranty concerning # the usability or impact on systems and may be used, distributed, and # modified in any way provided the parties agree and acknowledge the # Microsoft or Microsoft Partners have neither accountabilty or # responsibility for results produced by use of this script. # # Microsoft will not provide any support through any means. # ------------- DISCLAIMER ------------------------------------------------- # The CheckPackages function checks each task sequence, finding all the packages # that it references. It then checks each appropriate DP to make sure that the # needed packages are available on on those DPs. function CheckPackages { process { # Get the list of packages referenced by this task sequence $tsID = $_.PackageID $tsName = $_.Name # Setting up a Text-List of all DPs to see, which DP has all needed packages $DPsWithAllPackages = New-Object System.Collections.ArrayList foreach ($dp in $global:SelecteddpList) { $DPsWithAllPackages.Add($dp.Name) } Write-Host "###############################################################################################" Write-Host 'Checking the Packages for Task Sequence $tsID ("' -NoNewLine; Write-Host $tsName -NoNewLine -ForegroundColor Yellow ; Write-Host '")' $tsReferences = Get-SCCMObject SMS_TaskSequenceReferencesInfo "PackageID='$tsID' and ProgramName='*'" # Check each package Write-Verbose "Checking all packages..." foreach ($tsPackage in $tsReferences) { # Get a list of DPs for this package $tsPackageID = $tsPackage.ReferencePackageID Write-Verbose "Checking Package: $tspackageID" $tsReferenceDPs = Get-SCCMObject SMS_TaskSequenceReferenceDPs "TaskSequenceID='$tsID' and PackageID='$tsPackageID'" $packageNeededSomeWhere = $false $packageNeedingDPs = New-Object System.Collections.ArrayList # Check each DP to see if the package is on it foreach ($dp in $global:SelecteddpList) { $dpSiteCode = $dp.SiteCode $dpName = $dp.Name Write-Verbose "Checking DP $dpName" $found = $false foreach ($tsDP in $tsReferenceDPs) { if ($tsDP.ServerNALPath -eq $dp.NALPath) { Write-Verbose "$tsPackageID - Package Found" $found = $true break } } if ($found) { New-Object PSObject -Property @{SiteCode=$dpSiteCode; PackageID=($tsPackageID); ServerName=($dp.ServerName); ShareName=($dp.ShareName); NALPath=($dp.NALPath); Result="Found"} } else { # Check to see if this DP is a PXE Service Point, and if so mark as Not Needed. if ($tsPackage.ReferencePackageType -eq 258 -or (-not $dp.NALPath.Contains("SMSPXEIMAGES$"))) { Write-Verbose "$tsPackageID - Package Not Found" $packageNeededSomehere = $true $packageNeedingDPs.Add("$dpName |") $DPsWithAllPackages.Remove($dp.Name) New-Object PSObject -Property @{SiteCode=$dpSiteCode; PackageID=($tsPackageID); ServerName=($dp.ServerName); ShareName=($dp.ShareName); NALPath=($dp.NALPath); Result="Not Found"} } else { New-Object PSObject -Property @{SiteCode=$dpSiteCode; PackageID=($tsPackageID); ServerName=($dp.ServerName); ShareName=($dp.ShareName); NALPath=($dp.NALPath); Result="Not Needed"} } } } If ($packageNeededSomehere -eq $true) { Write-Host "===> " -NoNewLine; Write-Host "$tsPackageID" -ForegroundColor Red -NoNewline; Write-Host " is needed on: " -NoNewline; Write-Host $packageNeedingDPs $packageNeededSomehere = $false } else { Write-Host "===> " -NoNewLine; Write-Host "$tsPackageID" -ForegroundColor Green -NoNewline; Write-Host " is found on ALL selected DPs!" } } Write-Host "Tasksequence " -NoNewline; Write-Host "$tspackageID" -ForegroundColor Yellow -NoNewline; Write-Host " could be used on " -NoNewLine; Write-Host "$DPsWithAllPackages" -ForegroundColor Yellow Write-Host "###############################################################################################" } } # ---------- # Main logic # ---------- # Clear screen for the script cls # Prompt for ConfigMgr Server Name $ConfigMgr_Server = Read-Host "Enter Hostname of SCCM-Server to connect to, [ENTER] for localhost" If ($ConfigMgr_Server -eq ''){$ConfigMgr_Server = hostname} Write-Verbose "$ConfigMgr_Server is selected" # Connect to ConfigMgr Import-Module "D:\SOURCES\SCCM.psm1" -force Write-Host "Connecting to SCCM Server " -NoNewLine; Write-Host $ConfigMgr_Server -ForegroundColor Yellow New-SCCMConnection -serverName $ConfigMgr_Server # Get the list of all task sequences to choose from via a menu Write-Host "Getting a list of all Task Sequences to select from" Get-SCCMTaskSequencePackage | Sort-Object Name | ft Name,PackageID # Prompt for Task Sequence to use when checking packages $taskSequenceName = Read-Host 'Select Task Sequence (PackageID); [ENTER] to Cancel, "All" to check all Tasksequences' If ($taskSequenceName -eq 'Cancel' -or $taskSequenceName -eq $null) { Write-Host 'No Task Sequence selected or user selected "Cancel", exiting script...' Exit } ElseIf ($taskSequenceName -eq 'All') { $SelectedTS = $TaskSequences } Else { $SelectedTS = $TaskSequences | ? {$_.Name -eq $taskSequenceName} $SelectedTSID = $SelectedTS.PackageID } $SelectedTSID = $taskSequenceName # Get the list of all DPs to choose from via a menu Write-Host "Getting a list of all Distribution Points to select from" $global:dpList = Get-SCCMObject SMS_DistributionPointInfo $DPNameList = ($global:dpList| Select-Object @{Name="Name"; Expression={$_.ServerName}}, NalPath, SiteCode, SiteName) | Sort-Object Name ($global:dpList| Select-Object @{Name="Name"; Expression={$_.ServerName}}, SiteCode, SiteName) | Sort-Object Name # Prompt for Distribution Point to check the referenced packages against $global:DPName = Read-Host 'Enter Name of desired Distribution Point (FQDN); [ENTER] for localhost, "All" to check all DPs' If ($global:DPName -eq "") { Write-Verbose "[ENTER] pressed, setting localhost" $global:DPName = ([System.Net.Dns]::GetHostByName(($env:computerName))).HostName } If ($global:DPName -eq 'All') { Write-Verbose '"All" entered' $global:SelecteddpList = $DPNameList } Else { $global:SelecteddpList = $DPNameList | ? {$_.Name -eq $global:DPName} } # Get the package status for all packages referenced # by the task sequence selected. # Write-Host "Calling the CheckPackages function" If ($taskSequenceName -eq 'All') { Write-Verbose '"All" entered' $packageResults = Get-SCCMTaskSequencePackage | CheckPackages } Else { Write-Verbose 'Selected DP is $SelectedTSID' $packageResults = Get-SCCMTaskSequencePackage -filter "PackageID='$SelectedTSID'"| CheckPackages } |
Download-Link zum Skript:
www.hertes.net/wp-content/uploads/2013/06/Get-SCCMMissingTSPackages.ps1
Link zur sccm.psm1:
(Enthalten in CheckTaskSequences.zip)
SCCM2012: Content-Prestaging / Vorab bereitgestellte Inhalte
Oft müssen Content-Daten - z.B. in Form von WIM-Dateien für OSD - von einem Distribution Point (DP) zu einem anderen übertragen werden. Insbesondere bei größeren Dateien kann dies länger dauern, ein Versand der Daten auf dem Postweg wäre schneller.
Für diese Fälle bietet SCCM die Möglichkeit, Inhalte "vorab bereitzustellen", sie quasi auf einem DP zu exportieren, um sie an einem anderen zu importieren. Hierbei ist zu beachten, dass einen Unterschied macht, ob man den selben Content, den man an einer Stelle exportiert hat an einer anderen importiert, oder den Content mit Hilfe des ursprünglichen (z.B. WIM-)Files neu erstellt. Beim neu erstellen erhält der Content z.B. eine andere ID!
Die notwendigen Schritte sind die folgenden:
1. Content exportieren ("Datei für vorab bereitgestellten Inhalt erstellen")
Dazu muss via Rechtsklick auf den jeweiligen Content die Option "Datei für vorab bereitgestellten Inhalt erstellen" ausgewählt werden. Nun muss zum einen der Speicherort angegeben werden und zum zweiten der DP, von dem aus die Datei extrahiert werden soll. Am Ende hat man eine PKGX-Datei, eine gepackte Paketdatei. In dieser sind auch die Metadaten des Inhaltes enthalten. Es ist auch möglich, mehrere Content-Dateien in einem gemeinsamen PKGX-File zu exportieren.
2. Content an anderen DP verbringen
Hierzu muss die PKGX-Datei an den DP gebracht werden. Dies kann z.B. via DVD oder USB-Datenträger, aber auch per SMB-Filetransfer erfolgen.
3. DP für vorab bereitgestellten Inhalt aktivieren
Bevor Daten (Content) an einem DP importiert werden können, muss dieser erst für vorab bereitgestellte Inhalte aktiviert werden. Dies geschieht in den Eigenschaften des jeweiligen DPs:
4. Content importieren
Für den Import gibt es keine GUI, dies muss über Kommandozeile erfolgen. Dazu verwendet man extractcontent.exe aus dem BIN-Verzeichnis der SCCM-Installation. Mit dem Schalter /p wird das Paket angegeben, /s sorgt dafür, dass bereits vorhandener Content übersprungen wird.
Nun steht der Content am entfernten DP zur Verfügung!