SCClient

1.2

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
        $updateobj.ExclusiveUpdate=$update.ExclusiveUpdate
        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,ExclusiveUpdate,MaxExecutionTime,RebootOutsideServiceWindows,StartTime,UserUIExperience
}


<#
 .Synopsis
  Get installed software on the client.
 
 .Description
  You can use this commandlet to list all installed software 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-SCClientInstalledSoftware
   Get all installed software on the local computer.
 
 .Example
   Get-SCClientInstalledSoftware -ComputerName "ClientName" -Credential "CredentialObject"
   Get all installed software on the remote computer.
#>
function Get-SCClientInstalledSoftware {
param(
    [Parameter(Mandatory=$false)]
    [string] $ComputerName="localhost",
    [Parameter(Mandatory=$false)]
    [pscredential] $Credential
    ) 

    if($ComputerName -eq "localhost")
    {
        $InstalledApps = Get-WmiObject -Namespace "root\cimv2\sms" -Query "select * from SMS_InstalledSoftware" -ErrorAction Stop
    }
    else
    {
        $InstalledApps = Get-WmiObject -Namespace "root\cimv2\sms" -Query "select * from SMS_InstalledSoftware" -ComputerName $ComputerName -Credential $Credential -ErrorAction Stop
    }
    $InstalledAppsArr = @()

    foreach($InstalledApp in $InstalledApps)
    {
        $AppObj = @{}
        $AppObj.ProductName=$InstalledApp.ProductName
        $AppObj.Publisher=$InstalledApp.Publisher
        $AppObj.InstalledLocation=$InstalledApp.InstalledLocation
        $AppObj.ProductVersion=$InstalledApp.ProductVersion
        $AppObj.VersionMajor=$InstalledApp.VersionMajor
        $AppObj.VersionMinor=$InstalledApp.VersionMinor
        $AppObj.ServicePack=$InstalledApp.ServicePack
        $AppObj.SoftwareCode=$InstalledApp.SoftwareCode
        $AppObj.UninstallString=$InstalledApp.UninstallString
        $AppObj.LocalPackage=$InstalledApp.LocalPackage
        if($InstalledApp.InstallDate -ne $null)
        {
            $AppObj.InstallDate = [system.management.managementdatetimeconverter]::todatetime($InstalledApp.InstallDate)
        }
        $object = New-Object -TypeName psobject –Prop $AppObj
        $InstalledAppsArr += $object
    }
    return $InstalledAppsArr|select ProductName,Publisher,InstalledLocation,ProductVersion,VersionMajor,VersionMinor,ServicePack,SoftwareCode,UninstallString,LocalPackage,InstallDate
}


<#
 .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
    }
}