Public/Get-CCMProvisioningMode.ps1
|
function Get-CCMProvisioningMode { <# .SYNOPSIS Get ConfigMgr client provisioning mode info .DESCRIPTION This function will allow you to get the configuration manager client provisioning mode info using CIM queries. You can provide an array of computer names, or cimsession, or you can pass them through the pipeline. It will return a pscustomobject detailing provisioning mode .PARAMETER CimSession Provides CimSessions to get provisioning mode for .PARAMETER ComputerName Provides computer names to get provisioning mode for .EXAMPLE C:\PS> Get-CCMProvisioningMode -Status Enabled Retrieves provisioning mode info from the local computer .EXAMPLE C:\PS> Get-CCMProvisioningMode -ComputerName 'Workstation1234','Workstation4321' Retrieves provisioning mode info from Workstation1234, and Workstation4321 .NOTES FileName: Get-CCMProvisioningMode.ps1 Author: Cody Mathis Contact: @CodyMathis123 Created: 2020-01-09 Updated: 2020-01-09 #> [CmdletBinding(DefaultParameterSetName = 'ComputerName')] param ( [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, ParameterSetName = 'CimSession')] [Microsoft.Management.Infrastructure.CimSession[]]$CimSession, [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, ParameterSetName = 'ComputerName')] [Alias('Connection', 'PSComputerName', 'PSConnectionName', 'IPAddress', 'ServerName', 'HostName', 'DNSHostName')] [string[]]$ComputerName = $env:ComputerName ) begin { $getCIMRegistryPropertySplat = @{ RegRoot = 'HKEY_LOCAL_MACHINE' Key = 'Software\Microsoft\CCM\CcmExec' Property = 'ProvisioningMode', 'ProvisioningEnabledTime', 'ProvisioningMaxMinutes' } } process { foreach ($Connection in (Get-Variable -Name $PSCmdlet.ParameterSetName -ValueOnly)) { $Computer = switch ($PSCmdlet.ParameterSetName) { 'ComputerName' { Write-Output -InputObject $Connection switch ($Connection -eq $env:ComputerName) { $false { if ($ExistingCimSession = Get-CimSession -ComputerName $Connection -ErrorAction Ignore) { Write-Verbose "Active CimSession found for $Connection - Passing CimSession to CIM cmdlets" $getCIMRegistryPropertySplat.Remove('ComputerName') $getCIMRegistryPropertySplat['CimSession'] = $ExistingCimSession } else { Write-Verbose "No active CimSession found for $Connection - falling back to -ComputerName parameter for CIM cmdlets" $getCIMRegistryPropertySplat.Remove('CimSession') $getCIMRegistryPropertySplat['ComputerName'] = $Connection } } $true { $getCIMRegistryPropertySplat.Remove('CimSession') $getCIMRegistryPropertySplat.Remove('ComputerName') Write-Verbose 'Local computer is being queried - skipping computername, and cimsession parameter' } } } 'CimSession' { Write-Verbose "Active CimSession found for $Connection - Passing CimSession to CIM cmdlets" Write-Output -InputObject $Connection.ComputerName $getCIMRegistryPropertySplat.Remove('ComputerName') $getCIMRegistryPropertySplat['CimSession'] = $Connection } } $Return = [System.Collections.Specialized.OrderedDictionary]::new() $Return['ComputerName'] = $Computer try { $ProvisioningModeInfo = Get-CIMRegistryProperty @getCIMRegistryPropertySplat if ($ProvisioningModeInfo -is [object]) { $Return['ProvisioningMode'] = $ProvisioningModeInfo.$Computer.ProvisioningMode $EnabledTime = switch ([string]::IsNullOrWhiteSpace($ProvisioningModeInfo.$Computer.ProvisioningEnabledTime)) { $false { [timezone]::CurrentTimeZone.ToLocalTime(([datetime]'1/1/1970').AddSeconds($ProvisioningModeInfo.$Computer.ProvisioningEnabledTime)) } } $Return['ProvisioningEnabledTime'] = $EnabledTime $Return['ProvisioningMaxMinutes'] = $ProvisioningModeInfo.$Computer.ProvisioningMaxMinutes } } catch { $ErrorMessage = $_.Exception.Message Write-Error $ErrorMessage } [pscustomobject]$Return } } } |