SCClient.psm1
|
<#
.Synopsis Get pending updates on the client. .Description You can use this commandlet to check the pending updates on the client. .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Get-SCClientPendingUpdates Get all Pending updates on the local computer. .Example Get-SCClientPendingUpdates -ComputerName "ClientName" -Credential "CredentialObject" Get all Pending updates on the remote computer. .Example Get-SCClientPendingUpdates -ComputerName "ClientName" -Credential "CredentialObject" -UpdateID "UpdateID" Get all Pending updates on the local computer with a specific UpdateID. .Example Get-SCClientPendingUpdates -ComputerName "ClientName" -Credential "CredentialObject" -ArticleID "ArticleID" Get all Pending updates on the local computer with a specifi ArticleID. .Example Get-SCClientPendingUpdates -ComputerName "ClientName" -Credential "CredentialObject" -UpdateID "UpdateID" Get all Pending updates on the remote computer with a specific UpdateID. .Example Get-SCClientPendingUpdates -ComputerName "ClientName" -Credential "CredentialObject" -ArticleID "ArticleID" Get all Pending updates on the remote computer with a specifi ArticleID. #> function Get-SCClientPendingUpdates { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential, [Parameter(Mandatory=$false)] [string] $UpdateID="%", [Parameter(Mandatory=$false)] [string] $ArticleID="%" ) $modulepath = (Get-Module -ListAvailable SCClient).ModuleBase [xml]$XmlComplianceStates = Get-Content -Path $modulepath\ComplianceStateUpdates.xml [xml]$XmlEvaluationStates = Get-Content -Path $modulepath\EvaluationStateUpdates.xml if($ComputerName -eq "localhost") { $updates = Get-WmiObject -Namespace "Root\ccm\ClientSDK" -Query "SELECT * FROM CCM_SoftwareUpdate WHERE UpdateID like '$UpdateID' AND ArticleID like '$ArticleID'" -ErrorAction Stop } else { $updates = Get-WmiObject -ComputerName $ComputerName -Credential $Credential -Namespace "Root\ccm\ClientSDK" -Query "SELECT * FROM CCM_SoftwareUpdate WHERE UpdateID like '$UpdateID' AND ArticleID like '$ArticleID'" -ErrorAction Stop } $updatesArr = @() foreach($update in $updates) { $updateobj = @{} $updateobj.Name=$update.Name $updateobj.ArticleID=$update.ArticleID $updateobj.BulletinID=$update.BulletinID $updateobj.UpdateID=$update.UpdateID foreach($ComplianceState in $($XmlComplianceStates.states.option)) { if($ComplianceState.value -eq $update.ComplianceState) { $updateobj.ComplianceState=$ComplianceState.state } } foreach($EvaluationState in $($XmlEvaluationStates.states.option)) { if($EvaluationState.value -eq $update.EvaluationState) { $updateobj.EvaluationState=$EvaluationState.state } } $updateobj.MaxExecutionTime = $update.MaxExecutionTime $updateobj.RebootOutsideServiceWindows = $update.RebootOutsideServiceWindows $updateobj.URL = $update.URL $updateobj.ErrorCode = $update.ErrorCode $updateobj.StartTime = [system.management.managementdatetimeconverter]::todatetime($update.StartTime) $updateobj.Publisher = $update.Publisher $updateobj.UserUIExperience = $update.UserUIExperience $object = New-Object -TypeName psobject –Prop $updateobj $updatesArr += $object } return $updatesArr|select Name,Publisher,ArticleID,BulletinID,UpdateID,URL,ComplianceState,EvaluationState,ErrorCode,MaxExecutionTime,RebootOutsideServiceWindows,StartTime,UserUIExperience } <# .Synopsis Get applications deployed to the client. .Description You can use this commandlet to check the applications deployed to the client. .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Get-SCClientApplications Get all applications deployed to the local computer. .Example Get-SCClientApplications -ComputerName "ClientName" -Credential "CredentialObject" Get all applications deployed to the remote computer. #> function Get-SCClientApplication { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential ) $modulepath = (Get-Module -ListAvailable SCClient).ModuleBase [xml]$XmlEvaluationStates = Get-Content -Path $modulepath\EvaluationStateApps.xml if($ComputerName -eq "localhost") { $applications = Get-WmiObject -Namespace "Root\ccm\ClientSDK" -Query "SELECT * FROM CCM_application" -ErrorAction Stop } else { $applications = Get-WmiObject -ComputerName $ComputerName -Credential $Credential -Namespace "Root\ccm\ClientSDK" -Query "SELECT * FROM CCM_application" -ErrorAction Stop } $applicationsArr = @() foreach($application in $applications) { $AppObj = @{} $AppObj.AllowedActions=$application.AllowedActions $AppObj.ApplicabilityState=$application.ApplicabilityState $AppObj.ConfigurationState=$application.ConfigurationState switch($application.EnforcePreference) { 0{$AppObj.ConfigurationState="Immediate"} 1{$AppObj.ConfigurationState="NonBusinessHours"} 2{$AppObj.ConfigurationState="AdminSchedule"} default{$AppObj.ConfigurationState="Unknown"} } $AppObj.ErrorCode=$application.ErrorCode foreach($EvaluationState in $($XmlEvaluationStates.states.option)) { if($EvaluationState.value -eq $application.EvaluationState) { $AppObj.EvaluationState=$EvaluationState.state } } $AppObj.Name=$application.Name $AppObj.Id=$application.Id $AppObj.InstallState=$application.InstallState $AppObj.IsMachineTarget=$application.IsMachineTarget $AppObj.IsPreflightOnly=$application.IsPreflightOnly $AppObj.LastEvalTime = [system.management.managementdatetimeconverter]::todatetime($application.LastEvalTime) if($application.LastInstallTime -ne $null) { $AppObj.LastInstallTime = [system.management.managementdatetimeconverter]::todatetime($application.LastInstallTime) } if($application.Deadline -ne $null) { $AppObj.Deadline = [system.management.managementdatetimeconverter]::todatetime($application.Deadline) } $AppObj.NotifyUser=$application.NotifyUser $AppObj.OverrideServiceWindow=$application.OverrideServiceWindow $AppObj.PercentComplete=$application.PercentComplete $AppObj.Publisher=$application.Publisher $AppObj.RebootOutsideServiceWindow=$application.RebootOutsideServiceWindow $AppObj.ResolvedState=$application.ResolvedState $AppObj.StartTime = [system.management.managementdatetimeconverter]::todatetime($application.StartTime) $AppObj.UserUIExperience=$application.UserUIExperience $object = New-Object -TypeName psobject –Prop $AppObj $applicationsArr += $object } return $applicationsArr |Select Name,Publisher,Id,InstallState,EvaluationState,ResolvedState,ErrorCode,ApplicabilityState,ConfigurationState,PercentComplete,AllowedActions,IsMachineTarget,IsPreflightonly,RebootOutsideServiceWindow,OverrideServiceWindow,StartTime,DeadLine,LastEvalTime,LastInstallTime,NotifyUser,UserUIExperience } <# .Synopsis Get info about last update scan. .Description You can use this commandlet to view details of the last update scan. .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Get-SCClientUpdateScanHistory Get all Pending updates on the local computer. .Example Get-SCClientUpdateScanHistory -ComputerName "ClientName" -Credential "CredentialObject" Get all Pending updates on the remote computer. #> function Get-SCClientUpdateScanHistory { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential ) if($ComputerName -eq "localhost") { $ScanHistory = Get-WmiObject -Namespace root\ccm\scanagent -Query "SELECT * FROM CCM_scanupdatesourcehistory" -ErrorAction Stop } else { $ScanHistory = Get-WmiObject -ComputerName $ComputerName -Credential $Credential -Namespace root\ccm\scanagent -Query "SELECT * FROM CCM_scanupdatesourcehistory" -ErrorAction Stop } $ScanHistoryobj = @{} $ScanHistoryobj.ScanMethod = $ScanHistory.ScanMethod $ScanHistoryobj.Valid = $ScanHistory.Valid $ScanHistoryobj.ValidTTL = $ScanHistory.ValidTTL $ScanHistoryobj.UpdateSourceID = $ScanHistory.UpdateSourceID $ScanHistoryobj.UpdateSourceVersion = $ScanHistory.UpdateSourceVersion $ScanHistoryobj.LastCompletionTime = [system.management.managementdatetimeconverter]::todatetime($ScanHistory.LastCompletionTime) $object = New-Object -TypeName psobject –Prop $ScanHistoryobj return $object|select ScanMethod,Valid,ValidTTL,UpdateSourceID,UpdateSourceVersion,LastCompletionTime } <# .Synopsis Install updates .Description You can use this commandlet to install a specific update or all updates. .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Start-SCClientInstallUpdate -UpdateID "UpdateID" Install an update on the local computer .Example Start-SCClientInstallUpdate Install all update on the local computer .Example Start-SCClientInstallUpdate -ComputerName "ClientName" -Credential "CredentialObject" -UpdateID "UpdateID" Install an update with the specified UpdateID on the target computer .Example Start-SCClientInstallUpdate -ComputerName "ClientName" -Credential "CredentialObject" Install all updates on the target computer #> function Start-SCClientInstallUpdate { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential, [Parameter(Mandatory=$false)] [string] $UpdateID="%" ) if($ComputerName -eq "localhost") { $a = get-wmiobject -query "SELECT * FROM CCM_SoftwareUpdate WHERE UpdateID like '$UpdateID'" -namespace "ROOT\ccm\ClientSDK" -ErrorAction Stop ([wmiclass]'ROOT\ccm\ClientSDK:CCM_SoftwareUpdatesManager').InstallUpdates($a) } else { Invoke-Command $ComputerName -ScriptBlock{ param ([string] $arg1 = $UpdateID) $a = get-wmiobject -query "SELECT * FROM CCM_SoftwareUpdate WHERE UpdateID like '$arg1'" -namespace "ROOT\ccm\ClientSDK" -ErrorAction Stop ([wmiclass]'ROOT\ccm\ClientSDK:CCM_SoftwareUpdatesManager').InstallUpdates($a) } -ArgumentList $UpdateID -Credential $Credential } } <# .Synopsis Install updates .Description You can use this commandlet to install a specific update or all updates. .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Start-SCClientInstallApplication -Id "AppId" Install an application with the specified Application Id on the local computer .Example Start-SCClientInstallApplication -ComputerName "ClientName" -Credential "CredentialObject" -Id "AppId" Install an application with the specified Application Id on the target computer #> function Start-SCClientInstallApplication { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential, [Parameter(Mandatory=$true)] [string] $Id ) if($ComputerName -eq "localhost") { $a = get-wmiobject -query "SELECT * FROM CCM_Application WHERE Id like '$Id'" -namespace "ROOT\ccm\ClientSDK" -ErrorAction Stop $RELPATH = $a.__RELPATH -split "," if($RELPATH[1].Contains("TRUE")) { $IsMachineTarget = $true } else { $IsMachineTarget = $false } $revision = $RELPATH[2].Substring(10) $revision = $revision.Substring(0,$revision.Length-1) ([wmiclass]'ROOT\ccm\ClientSdk:CCM_Application').Install($Id, $revision, $IsMachineTarget, 0, 'Normal', $False) } else { Invoke-Command $ComputerName -ScriptBlock{ param ([string] $arg1 = $Id) $a = get-wmiobject -query "SELECT * FROM CCM_Application WHERE Id like '$arg1'" -namespace "ROOT\ccm\ClientSDK" -ErrorAction Stop $RELPATH = $a.__RELPATH -split "," if($RELPATH[1].Contains("TRUE")) { $IsMachineTarget = $true } else { $IsMachineTarget = $false } $revision = $RELPATH[2].Substring(10) $revision = $revision.Substring(0,$revision.Length-1) ([wmiclass]'ROOT\ccm\ClientSdk:CCM_Application').Install($arg1, $revision, $IsMachineTarget, 0, 'Normal', $False) } -ArgumentList $Id -Credential $Credential } } <# .Synopsis Start a Software Updates Assignments Evaluation Cycle .Description You can use this commandlet to start a Software Updates Assignments Evaluation Cycle or Software Update Deployment Evaluation Cycle .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Start-SCClientUpdateDeploymentEval Start Software Updates Assignments Evaluation Cycle on the local computer .Example Start-SCClientUpdateDeploymentEval -ComputerName "ClientName" -Credential "CredentialObject" Start Software Updates Assignments Evaluation Cycle on the remote computer #> function Start-SCClientUpdateDeploymentEval { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential ) if($ComputerName -eq "localhost") { ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000108}') } else { Invoke-Command $ComputerName -ScriptBlock{ ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000108}') } -Credential $Credential } } <# .Synopsis Start a Software Update Scan Cycle .Description You can use this commandlet to start a Software Update Scan Cycle .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Start-SCClientUpdateScan Start Software Update Scan Cycle on the local computer .Example Start-SCClientUpdateScan -ComputerName "ClientName" -Credential "CredentialObject" Start Software Update Scan Cycle on the remote computer #> function Start-SCClientUpdateScan { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential ) if($ComputerName -eq "localhost") { ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000113}') } else { Invoke-Command $ComputerName -ScriptBlock{ ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000113}') } -Credential $Credential } } <# .Synopsis Start a Machine Policy Retrieval and Evaluation Cycle. .Description You can use this commandlet to start a Machine Policy Retrieval and Evaluation Cycle. .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Start-SCClientMachinePolicyEval Start Machine Policy Retrieval and Evaluation Cycle on the local computer .Example Start-SCClientMachinePolicyEval -ComputerName "ClientName" -Credential "CredentialObject" Start Machine Policy Retrieval and Evaluation Cycle on the remote computer #> function Start-SCClientMachinePolicyEval { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential ) if($ComputerName -eq "localhost") { ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000021}') ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000022}') } else { Invoke-Command $ComputerName -ScriptBlock{ ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000021}') ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000022}') } -Credential $Credential } } <# .Synopsis Start a Application Deployment Evaluation Cycle. .Description You can use this commandlet to start a Application Deployment Evaluation Cycle. .Parameter ComputerName The computer you like to target. .Parameter Credential The credentials you like to use to manage the target computer. .Example Start-SCClientApplicationEval Start Application Deployment Evaluation Cycle on the local computer .Example Start-SCClientApplicationEval -ComputerName "ClientName" -Credential "CredentialObject" Start Application Deployment Evaluation Cycle on the remote computer #> function Start-SCClientApplicationEval { param( [Parameter(Mandatory=$false)] [string] $ComputerName="localhost", [Parameter(Mandatory=$false)] [pscredential] $Credential ) if($ComputerName -eq "localhost") { ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000121}') } else { Invoke-Command $ComputerName -ScriptBlock{ ([wmiclass]'ROOT\ccm:SMS_Client').TriggerSchedule('{00000000-0000-0000-0000-000000000121}') } -Credential $Credential } } |