Public/Connect-CCM.ps1
|
function Connect-CCM { <# .SYNOPSIS This function establishes a connection to an SCCM Server system. .DESCRIPTION This function establishes a connection to an SCCM Server system. The function creates a CIM session [CimSession], queries the server for the SCCM site and namespace, and stores connection information in a global variable .INPUTS [string] .OUTPUTS [CimInstance] .EXAMPLE C:\PS>Connect-CCM -Server WINSCCM01 Connects to the SCCM server WINSCCM01 #> [CmdletBinding()] Param ( #The name of the SCCM server [Parameter(Mandatory = $true)] [string]$ComputerName, #Removes previous CimSession if found [Parameter()] [switch]$Reconnect, #Specifies a PSCredential object that contains credentials for authenticating with the server [Parameter()] [System.Management.Automation.PSCredential] $Credential ) begin { $cimSessionParam = @{ ComputerName = $ComputerName Name = "ccmConnection" } if ($Credential) { $cimSessionParam['Credential'] = $Credential } } process { try { Write-Verbose "Looking for CIM Session 'ccmConnection'" $cimSession = Get-CimSession -Name 'ccmConnection' -ErrorAction Stop Write-Verbose 'Session Found' if ($Reconnect) { Remove-CimSession -CimSession $cimSession New-CimSession @cimSessionParam -ErrorAction Stop } } catch { Write-Verbose 'session not found' $cimSession = New-CimSession @cimSessionParam -ErrorAction Stop } $siteParam = @{ ClassName = 'SMS_ProviderLocation' NameSpace = 'root/sms' } $siteName = (Get-CimInstance @siteParam -CimSession $cimSession -ErrorAction Stop)[0].NamespacePath -replace '^.+site_' } end { Set-Variable -Name global:CCMConnection -Value @{ CimSession = $cimSession | Select-Object -First 1 NameSpace = 'root\sms\site_{0}' -f $siteName } } } |