document.write('\
\ '); document.write('
  1. # SystemsManagementServer.psm1
    2. \
  2. # written by Tojo2000 <tojo2000@tojo2000.com>
    3. \
  3. # Last updated on 20080921
    4. \
  4. #
    5. \
  5. # Functions for getting data from MS Systems Management Server.
    6. \
  6.  
    7. \
  7.  
    8. \
  8. # Set default server and site name here.  It should be the server with the SMS
    9. \
  9. # Provider, not necessarily the site server.
    10. \
  10.  
    11. \
  11. [string]$default_wmi_provider_server = \'servername\'
    12. \
  12. [string]$default_site = \'S00\'
    13. \
  13.  
    14. \
  14.  
    15. \
  15. # Get-SmsWmi
    16. \
  16. # A wrapper for Get-WmiObject that makes it easy to get objects from SMS.
    17. \
  17. #
    18. \
  18. # Args:
    19. \
  19. #   $class: the WMI class or nickname to retrieve
    20. \
  20. #   $filter: the where clause of the query
    21. \
  21. #   $computer_name: the SMS server hosting the SMS Provider
    22. \
  22. #   $site: the SMS Site Code of the target site
    23. \
  23. # Returns:
    24. \
  24. #   An array of WMI objects
    25. \
  25.  
    26. \
  26. function Get-SmsWmi {
    27. \
  27.   param([string]$class = $(Throw @"
    28. \
  28. `t
    29. \
  29. ERROR: You must enter a class name or nickname.
    30. \
  30. `t
    31. \
  31. Valid nicknames are:
    32. \
  32. `t
    33. \
  33.   AddRemovePrograms
    34. \
  34.   AdStatus
    35. \
  35.   Advertisement
    36. \
  36.   Collection
    37. \
  37.   ComputerSystem
    38. \
  38.   DistributionPoint
    39. \
  39.   LogicalDisk
    40. \
  40.   MembershipRule
    41. \
  41.   NetworkAdapter
    42. \
  42.   NetworkAdapterConfiguration
    43. \
  43.   OperatingSystem
    44. \
  44.   Package
    45. \
  45.   PackageStatus
    46. \
  46.   Program
    47. \
  47.   Query
    48. \
  48.   Server
    49. \
  49.   Service
    50. \
  50.   Site
    51. \
  51.   StatusMessage
    52. \
  52.   System
    53. \
  53.   WorkstationStatus
    54. \
  54.   User
    55. \
  55. `t
    56. \
  56. Note: You only need to type as many characters as necessary to be unambiguous.
    57. \
  57. `t
    58. \
  58. "@),
    59. \
  59.         [string]$filter = $null,
    60. \
  60.         [string]$computer_name = $default_wmi_provider_server,
    61. \
  61.         [string]$site = $default_site)
    62. \
  62.  
    63. \
  63.   $classes = @{\'collection\' = \'SMS_Collection\';
    64. \
  64.                \'package\' = \'SMS_Package\';
    65. \
  65.                \'program\' = \'SMS_Program\';
    66. \
  66.                \'system\' = \'SMS_R_System\';
    67. \
  67.                \'server\' = \'SMS_SystemResourceList\';
    68. \
  68.                \'advertisement\' = \'SMS_Advertisement\';
    69. \
  69.                \'query\' = \'SMS_Query\';
    70. \
  70.                \'membershiprule\' = \'SMS_CollectionMembershipRule\';
    71. \
  71.                \'statusmessage\' = \'SMS_StatusMessage\';
    72. \
  72.                \'site\' = \'SMS_Site\';
    73. \
  73.                \'user\' = \'SMS_R_User\';
    74. \
  74.                \'pkgstatus\' = \'SMS_PackageStatus\';
    75. \
  75.                \'addremoveprograms\' = \'SMS_G_System_ADD_REMOVE_PROGRAMS\';
    76. \
  76.                \'computersystem\' = \'SMS_G_System_COMPUTER_SYSTEM\';
    77. \
  77.                \'operatingsystem\' = \'SMS_G_System_OPERATING_SYSTEM\';
    78. \
  78.                \'service\' = \'SMS_G_System_SERVICE\';
    79. \
  79.                \'workstationstatus\' = \'SMS_G_System_WORKSTATION_STATUS\';
    80. \
  80.                \'networkadapter\' = \'SMS_G_System_NETWORK_ADAPTER\';
    81. \
  81.                \'networkadapterconfiguration\' = (\'SMS_G_System_NETWORK_\' +
    82. \
  82.                                                 \'ADAPTER_CONFIGURATION\');
    83. \
  83.                \'logicaldisk\' = \'SMS_G_System_LOGICAL_DISK\';
    84. \
  84.                \'distributionpoint\' = \'SMS_DistributionPoint\';
    85. \
  85.                \'adstatus\' = \'SMS_ClientAdvertisementStatus\'}
    86. \
  86.  
    87. \
  87.   $matches = @();
    88. \
  88.  
    89. \
  89.   foreach ($class_name in @($classes.Keys | sort)) {
    90. \
  90.     if ($class_name.StartsWith($class.ToLower())) {
    91. \
  91.       $matches += $classes.($class_name)
    92. \
  92.     }
    93. \
  93.   }
    94. \
  94.  
    95. \
  95.   if ($matches.Count -gt 1) {
    96. \
  96.     Write-Error @"
    97. \
  97. `t
    98. \
  98. Warning: Class provided matches more than one nickname.
    99. \
  99. `t
    100. \
  100. Type \'Get-SMSWmi\' with no parameters to see a list of nicknames.
    101. \
  101. `t
    102. \
  102. "@
    103. \
  103.     $class = $matches[0]
    104. \
  104.   } elseif ($matches.Count -eq 1) {
    105. \
  105.     $class = $matches[0]
    106. \
  106.   }
    107. \
  107.  
    108. \
  108.   $query = "Select * From $class"
    109. \
  109.  
    110. \
  110.   if ($filter) {
    111. \
  111.     $query += " Where $filter"
    112. \
  112.   }
    113. \
  113.  
    114. \
  114.   # Now that we have our parameters, let\'s execute the command.
    115. \
  115.   $namespace = \'root\\sms\\site_\' + $site
    116. \
  116.   gwmi -ComputerName $computer_name -Namespace $namespace -Query $query
    117. \
  117. }
    118. \
  118.  
    119. \
  119.  
    120. \
  120. # Find-SmsId
    121. \
  121. # Look up an SMS ID.
    122. \
  122. #
    123. \
  123. # Args:
    124. \
  124. #   $advertisement_id,
    125. \
  125. #   $collection_id,
    126. \
  126. #   $package_id,
    127. \
  127. #   $resource_id: The id type to look up.  Pick only one type.
    128. \
  128. #   $id: The ID to look up
    129. \
  129. #
    130. \
  130. # Returns:
    131. \
  131. #   An sms object if one was found
    132. \
  132.  
    133. \
  133. function Find-SmsID {
    134. \
  134.   param([switch]$advertisement_id,
    135. \
  135.         [switch]$collection_id,
    136. \
  136.         [switch]$resource_id,
    137. \
  137.         [switch]$package_id,
    138. \
  138.         [string]$id)
    139. \
  139.   $Class = \'\'
    140. \
  140.   $Type = \'\'
    141. \
  141.  
    142. \
  142.     if ($advertisement_id) {
    143. \
  143.       $type = \'AdvertisementID\'
    144. \
  144.       $class = \'Advertisement\'
    145. \
  145.     } elseif ($collection_id) {
    146. \
  146.       $type = \'CollectionID\'
    147. \
  147.       $class = \'Collection\'
    148. \
  148.     } elseif ($package_id) {
    149. \
  149.       $type = \'PackageID\'
    150. \
  150.       $class = \'Package\'
    151. \
  151.     } elseif ($resource_id) {
    152. \
  152.       $type = \'ResourceID\'
    153. \
  153.       $class = \'System\'
    154. \
  154.     } else {
    155. \
  155.       Throw @"
    156. \
  156. `t
    157. \
  157. You must specify an ID type.  Valid switches are:
    158. \
  158. `t
    159. \
  159. `t-advertisement_id
    160. \
  160. `t-collection_id
    161. \
  161. `t-package_id
    162. \
  162. `t-resource_id
    163. \
  163. `t
    164. \
  164. USAGE: Find-SmsID <Type> <ID>
    165. \
  165. `t
    166. \
  166. "@
    167. \
  167.     }
    168. \
  168.  
    169. \
  169.   if ($resource_id) {
    170. \
  170.     trap [System.Exception] {
    171. \
  171.       Write-Output "`nERROR: Invalid Input for ResourceID!`n"
    172. \
  172.       break
    173. \
  173.     }
    174. \
  174.        
    175. \
  175.     $type = \'ResourceID\'
    176. \
  176.     $class = \'System\'
    177. \
  177.     [int]$id = $id  # Throws an exception if it\'s not a number
    178. \
  178.   } else{
    179. \
  179.     if ($id -notmatch \'^[a-zA-Z0-9]{8}$\') {
    180. \
  180.       Throw "`n`t`nERROR: Invalid ID format.`n`t`n"
    181. \
  181.     }
    182. \
  182.   }
    183. \
  183.  
    184. \
  184.   Get-SmsWmi $class "$type = `"$ID`""
    185. \
  185. }
');document.write('
downloadThis Script brought to you by PoshCode\
\
\
');