Voilà, it is time to share the next set of cmdlets.
Today’s functions are the following ones :
Again, the base commands are still the same as the ones in the version 1.0 (Get-SccmCommands, Get-SccmObject, Connect-SCCMServer). The new cmdlets are the ‘only’ the task sequence cmdlets that were never present in the first version of the module.
[important] These Functions are part of a bigger module : “Sccm-Commands“. This module has been developed through the years by the community and is provided as is. To get the full version (revised) version you will need to be a bit more patient for now ;). The complete “updated version” will be posted online soon .[/important]
|
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
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
|
# – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –
# Stéphane van Gulick / PowerShellDistrict.Com
# Rikard Ronnkvist / snowland.se
# Usage:
# Save the file as SCCM-Commands.psm1
# PS:>Import-Module SCCM-Commands
# PS:>Get-SCCMCommands
#
# Current Version : 1.0
#
# 2009-04-07 Michael Niehaus Original code posted at http://blogs.technet.com/mniehaus/
# 2010-03-10 Rikard Ronnkvist Major makeover and first snowland.se release
# …
# 2014-01-01 Stéphane van Gulick New Functions: # New Functions:[Task Sequence] : Export-SCCMTaskSequence, Import-SCCMTaskSequencePackage
# – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –
#Region BaseCommands
Function Get-SCCMCommands {
# List all SCCM-commands
[CmdletBinding()]
PARAM ()
PROCESS {
return Get-Command -Name *-SCCM* -CommandType Function | Sort-Object Name | Format-Table Name, Module
}
}
Function Connect-SCCMServer {
# Connect to one SCCM server
[CmdletBinding()]
PARAM (
[Parameter(Mandatory=$false,HelpMessage=“SCCM Server Name or FQDN”,ValueFromPipeline=$true)][Alias(“ServerName”,“FQDN”,“ComputerName”)][String] $HostName = (Get-Content env:computername),
[Parameter(Mandatory=$false,HelpMessage=“Optional SCCM Site Code”,ValueFromPipelineByPropertyName=$true )][String] $siteCode = $null,
[Parameter(Mandatory=$false,HelpMessage=“Credentials to use” )][System.Management.Automation.PSCredential] $credential = $null
)
PROCESS {
# Get the pointer to the provider for the site code
if ($siteCode -eq $null -or $siteCode -eq “”) {
Write-Verbose “Getting provider location for default site on server $HostName”
if ($credential -eq $null) {
$sccmProviderLocation = Get-WmiObject -query “select * from SMS_ProviderLocation where ProviderForLocalSite = true” -Namespace “rootsms” -computername $HostName -errorAction Stop
} else {
$sccmProviderLocation = Get-WmiObject -query “select * from SMS_ProviderLocation where ProviderForLocalSite = true” -Namespace “rootsms” -computername $HostName -credential $credential -errorAction Stop
}
} else {
Write-Verbose “Getting provider location for site $siteCode on server $HostName”
if ($credential -eq $null) {
$sccmProviderLocation = Get-WmiObject -query “SELECT * FROM SMS_ProviderLocation where SiteCode = ‘$siteCode'” -Namespace “rootsms” -computername $HostName -errorAction Stop
} else {
$sccmProviderLocation = Get-WmiObject -query “SELECT * FROM SMS_ProviderLocation where SiteCode = ‘$siteCode'” -Namespace “rootsms” -computername $HostName -credential $credential -errorAction Stop
}
}
# Split up the namespace path
$parts = $sccmProviderLocation.NamespacePath -split “”, 4
Write-Verbose “Provider is located on $($sccmProviderLocation.Machine) in namespace $($parts[3])”
# Create a new object with information
$retObj = New-Object -TypeName System.Object
$retObj | add-Member -memberType NoteProperty -name Machine -Value $HostName
$retObj | add-Member -memberType NoteProperty -name Namespace -Value $parts[3]
$retObj | add-Member -memberType NoteProperty -name SccmProvider -Value $sccmProviderLocation
return $retObj
}
}
Function Get-SCCMObject {
# Generic query tool
[CmdletBinding()]
PARAM (
[Parameter(Mandatory=$true, HelpMessage=“SCCM Server”,ValueFromPipelineByPropertyName=$true)][Alias(“Server”,“SmsServer”)][System.Object] $SccmServer,
[Parameter(Mandatory=$true, HelpMessage=“SCCM Class to query”,ValueFromPipeline=$true)][Alias(“Table”,“View”)][String] $class,
[Parameter(Mandatory=$false,HelpMessage=“Optional Filter on query”)][String] $Filter = $null
)
PROCESS {
if ($Filter -eq $null -or $Filter -eq “”)
{
Write-Verbose “WMI Query: SELECT * FROM $class”
$retObj = get-wmiobject -class $class -computername $SccmServer.Machine -namespace $SccmServer.Namespace
}
else
{
Write-Verbose “WMI Query: SELECT * FROM $class WHERE $Filter”
$retObj = get-wmiobject -query “SELECT * FROM $class WHERE $Filter” -computername $SccmServer.Machine -namespace $SccmServer.Namespace
}
return $retObj
}
}
# – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –
#endregion
#region Task Sequence
# – – – – – – – – – – Task Sequences – – – – – – – – – –
Function Get-SCCMTaskSequenceRelatedPackages {
<#
.SYNOPSIS
Returnes the list of packages that a present in a Task sequence.
.DESCRIPTION
Returnes the list of packages that a present in a Task sequence.
.PARAMETER SccmServer
Sccm Connection object created with Connect-SccmServer
.EXAMPLE
$Connection = Connect-SccmServer “MyServer01”
Get-SccmTaskSequenceRelatedPackages -SccmServer $connection
.NOTES
Author: Stéphane van Gulick
version: 1.0
History:
.LINK
www.PowerShellDistrict.com
#>
[CmdletBinding()]
PARAM (
[Parameter(Mandatory=$true, HelpMessage=“SCCM Server”,ValueFromPipeline=$true)][Alias(“Server”,“SmsServer”)][System.Object] $SccmServer,
[Parameter(Mandatory=$false, HelpMessage=“Task Sequence name”)][String] $Name,
[Parameter(Mandatory=$false, HelpMessage=“Path to the folder”)][String] $Description,
[Parameter(Mandatory=$false, HelpMessage=“Optional Filter on query”)][String] $Sequence = $null
)
PROCESS {
$References = (Get-SCCMTaskSequencePackage -SccmServer $SccmServer -Name $Name -Full).references
$Packages = @()
Foreach ($Reference in $References){
$PackageName = $null
$PackageName = (Get-SCCMPackage -SccmServer $SccmServer -PackageID $($Reference.package)).name
if ($PackageName){
$Properties = @{‘Name’=$PackageName;‘Program’=$($Reference.Program)}
$Packages += New-Object -TypeName psobject -Property $Properties
}
}
return $Packages
}
}
Function Import-SCCMTaskSequenceXML {
<#
.SYNOPSIS
Imports a Task Sequence based on a exported XML file.
.DESCRIPTION
Returnes the list of packages that a present in a Task sequence.
.PARAMETER SccmServer
Sccm Connection object created with Connect-SccmServer
.EXAMPLE
$Connection = Connect-SccmServer “MyServer01”
.NOTES
Author: Stéphane van Gulick
version: 1.0
History:
.LINK
www.PowerShellDistrict.com
#>
[CmdletBinding()]
PARAM (
[Parameter(Mandatory=$true, HelpMessage=“SCCM Server”,ValueFromPipeline=$true)][Alias(“Server”,“SmsServer”)][System.Object] $SccmServer,
[Parameter(Mandatory=$false, HelpMessage=“Name of the new task sequence”)][String] $Name,
[Parameter(Mandatory=$false, HelpMessage=“Description”)][String] $Description,
[Parameter(Mandatory=$false, HelpMessage=“Path to the XML file”)][String] $XMLFile = $null,
[Parameter(Mandatory=$false, HelpMessage=“BootImageID”)][String] $BootImageID =$null,
[Parameter(Mandatory=$false, HelpMessage=“DependentProgram”)][String] $DependentProgram
)
PROCESS {
#Gathering XML content :
$XMLFileContent = $XMLFile
#Getting SMS_TaskSequencePackage class
$TaskSequencePackageClass = [WmiClass](“$($SccmServer.machine)$($SccmServer.namespace):SMS_TaskSequencePackage”)
#Importing XML
$importedsequence = ($TaskSequencePackageClass.ImportSequence($XMLFileContent)).TaskSequence
#Creating Instance
$NewInstance = $TaskSequencePackageClass.createinstance()
$NewInstance.Name = $Name
$NewInstance.Description = $Description
$NewInstance.BootImageID= $BootImageID
$NewInstance.DependentProgram=$DependentProgram
#Importing Task Sequence
$TaskSequencePackageClass.SetSequence($NewInstance,$importedsequence)
return $importedsequence
}
}
Function Export-SCCMTaskSequence {
<#
.SYNOPSIS
Exports the SCCM Task sequence to an Xml file format.
.DESCRIPTION
.PARAMETER SccmServer
Sccm Connection object created with Connect-SccmServer
.PARAMETER PackageID
The task sequence package ID of the task sequence to export.
.PARAMETER Name
The name of task sequence to export.
.PARAMETER Path
The path where the XML file should be saved.
.EXAMPLE
$Connection = Connect-SccmServer “MyServer01”
Export-SccmTaskSequence -SccmServer $connection -name “Windows 7 deployment x64” -Path “shareexportsWindows7deploymentx64.xml”
.NOTES
Author: Stéphane van Gulick
version: 1.0
History:
.LINK
www.PowerShellDistrict.com
#>
[CmdletBinding()]
PARAM (
[Parameter(Mandatory=$true, HelpMessage=“SCCM Server”,ValueFromPipeline=$true)][Alias(“Server”,“SmsServer”)][System.Object] $SccmServer,
[Parameter(Mandatory=$false, HelpMessage=“Gets task sequence according to name.”)][String] $Name = $null,
[Parameter(Mandatory=$false, HelpMessage=“Gets task sequence according to PAckageID.”)][String] $PackageID = $null,
[Parameter(Mandatory=$false, HelpMessage=“File with XML extension.”)][String] $Path = $null
)
PROCESS {
If ($name){
$TaskSequenceXML = (Get-SCCMTaskSequencePackage -SccmServer $sccmServer -Name $Name -Full).sequence
}
elseif($PackageID){
$TaskSequenceXML = (Get-SCCMTaskSequencePackage -SccmServer $sccmServer -Name $Name -Full).sequence
}
if ($path){
$TaskSequenceXML | Out-File $Path
}
else{
Return $TaskSequenceXML
}
}
end{
}
}
Function Get-SCCMTaskSequencePackage {
<#
.SYNOPSIS
Gets a SCCM Task sequence package.
.DESCRIPTION
.PARAMETER SccmServer
Sccm Connection object created with Connect-SccmServer
.PARAMETER PackageID
Get the TS package according to his Task sequence package ID.
.PARAMETER Name
Get the TS package according to his Task sequence name.
.PARAMETER Path
The path where the XML file should be saved.
.EXAMPLE
$Connection = Connect-SccmServer “MyServer01”
Get-SCCMTaskSequencePackage -SccmServer $connection -name “Windows 7 deployment x64”
.NOTES
Author: Stéphane van Gulick
version: 1.0
History:
.LINK
www.PowerShellDistrict.com
#>
[CmdletBinding()]
PARAM (
[Parameter(Mandatory=$true, HelpMessage=“SCCM Server”,ValueFromPipeline=$true)][Alias(“Server”,“SmsServer”)][System.Object] $SccmServer,
[Parameter(Mandatory=$false, HelpMessage=“Optional Filter on query”)][String] $Name = $null,
[Parameter(Mandatory=$false, HelpMessage=“Optional Filter on query”)][String] $PackageID = $null,
[Parameter(Mandatory=$false, HelpMessage=“Optional Filter on query”)][String] $Filter = $null,
[Parameter(Mandatory=$false, HelpMessage=“Full”)][Switch] $Full
)
PROCESS {
If ($name){
$res = Get-SCCMObject -sccmServer $SccmServer -class “SMS_TaskSequencePackage” -Filter “Name=’$Name'”
}elseif($PackageID){
$res = Get-SCCMObject -sccmServer $SccmServer -class “SMS_TaskSequencePackage” -Filter “PackageID=’$PackageID'”
}else{
$res = Get-SCCMObject -sccmServer $SccmServer -class “SMS_TaskSequencePackage” -Filter $Filter
}
if ($Full){
$res.get()
}
}
end{
return $res
}
}
Function Get-SCCMTaskSequence {
[CmdletBinding()]
PARAM (
[Parameter(Mandatory=$true, HelpMessage=“SCCM Server”,ValueFromPipeline=$true)][Alias(“Server”,“SmsServer”)][System.Object] $SccmServer,
[Parameter(Mandatory=$false, HelpMessage=“Optional Filter on query”)][String] $Filter = $null
)
PROCESS {
return Get-SCCMObject -sccmServer $SccmServer -class “SMS_TaskSequence” -Filter $Filter
}
}
#endregion
|
Leave A Comment