Modules/M365DSCTelemetryEngine.psm1
|
<#
.SYNOPSIS Returns the path of the per-user telemetry settings file used outside Windows. .FUNCTIONALITY Internal, Hidden .OUTPUTS System.String #> function Get-M365DSCTelemetrySettingsFilePath { [CmdletBinding()] [OutputType([System.String])] param() $configurationRoot = [System.Environment]::GetFolderPath([System.Environment+SpecialFolder]::ApplicationData) return [System.IO.Path]::Combine($configurationRoot, 'Microsoft365DSC', 'TelemetrySettings.json') } <# .SYNOPSIS Reads a telemetry setting. .DESCRIPTION On Windows, reads the machine environment variable. On other platforms, where machine environment variables cannot be stored, reads the process environment variable and falls back to the per-user telemetry settings file. .PARAMETER Name Specifies the name of the setting, such as M365DSCTelemetryEnabled. .FUNCTIONALITY Internal, Hidden .OUTPUTS System.String #> function Get-M365DSCTelemetrySetting { [CmdletBinding()] [OutputType([System.String])] param ( [Parameter(Mandatory = $true)] [System.String] $Name ) if ($IsWindows) { return [System.Environment]::GetEnvironmentVariable($Name, [System.EnvironmentVariableTarget]::Machine) } $value = [System.Environment]::GetEnvironmentVariable($Name, [System.EnvironmentVariableTarget]::Process) if (-not [System.String]::IsNullOrEmpty($value)) { return $value } $settingsFilePath = Get-M365DSCTelemetrySettingsFilePath if (-not [System.IO.File]::Exists($settingsFilePath)) { return $null } try { $settings = [System.IO.File]::ReadAllText($settingsFilePath) | ConvertFrom-Json -AsHashtable if ($null -ne $settings -and $settings.ContainsKey($Name)) { return [System.String]$settings[$Name] } } catch { Write-Verbose -Message "Could not read the telemetry settings file {$settingsFilePath}: $($_.Exception.Message)" } return $null } <# .SYNOPSIS Stores a telemetry setting. .DESCRIPTION On Windows, writes the machine environment variable, which requires administrator privileges. On other platforms, writes the per-user telemetry settings file and the process environment variable. An empty value removes the setting. .PARAMETER Name Specifies the name of the setting, such as M365DSCTelemetryEnabled. .PARAMETER Value Specifies the value of the setting. .FUNCTIONALITY Internal, Hidden #> function Set-M365DSCTelemetrySetting { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $Name, [Parameter()] [AllowNull()] [AllowEmptyString()] [System.String] $Value ) if ($IsWindows) { try { [System.Environment]::SetEnvironmentVariable($Name, $Value, [System.EnvironmentVariableTarget]::Machine) } catch [System.Security.SecurityException], [System.UnauthorizedAccessException] { throw 'Changing the telemetry settings requires administrator privileges. Run the command from an elevated PowerShell session.' } return } $settingsFilePath = Get-M365DSCTelemetrySettingsFilePath $settings = @{} if ([System.IO.File]::Exists($settingsFilePath)) { $existing = [System.IO.File]::ReadAllText($settingsFilePath) | ConvertFrom-Json -AsHashtable if ($null -ne $existing) { $settings = $existing } } $processValue = [System.Management.Automation.Language.NullString]::Value if ([System.String]::IsNullOrEmpty($Value)) { $settings.Remove($Name) } else { $settings[$Name] = $Value $processValue = $Value } $null = [System.IO.Directory]::CreateDirectory([System.IO.Path]::GetDirectoryName($settingsFilePath)) [System.IO.File]::WriteAllText($settingsFilePath, ($settings | ConvertTo-Json)) [System.Environment]::SetEnvironmentVariable($Name, $processValue, [System.EnvironmentVariableTarget]::Process) } $Script:TelemetryEnabled = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryEnabled' $Script:M365DSCCurrentRolesResolved = $false $Script:M365DSCCurrentRoles = @() # Telemetry workload names, keyed by resource name prefix. $Script:M365DSCTelemetryWorkloadNames = [ordered]@{ 'AAD' = 'Azure Active Directory' 'ADO' = 'Azure DevOps' 'Azure' = 'Azure' 'Commerce' = 'Commerce' 'Defender' = 'Defender' 'EXO' = 'Exchange Online' 'Fabric' = 'Microsoft Fabric' 'Intune' = 'Intune' 'O365' = 'Office 365 Admin' 'OD' = 'OneDrive for Business' 'Planner' = 'Planner' 'PP' = 'Power Platform' 'SC' = 'Security and Compliance Center' 'Sentinel' = 'Sentinel' 'SH' = 'Services Hub' 'SPO' = 'SharePoint Online' 'Teams' = 'Teams' 'Viva' = 'Microsoft Viva' } <# .SYNOPSIS Returns whether Microsoft365DSC telemetry is enabled. .DESCRIPTION Evaluates the machine-scoped telemetry flag and returns true when telemetry is enabled or not explicitly disabled. .FUNCTIONALITY Internal .OUTPUTS System.Boolean #> function Test-IsM365DSCTelemetryEnabled { [CmdletBinding()] [OutputType([System.Boolean])] param() if ($null -eq $Script:TelemetryEnabled -or $Script:TelemetryEnabled -eq $true) { return $true } else { return $false } } <# .DESCRIPTION This function gets the Application Insights key to be used for storing telemetry .FUNCTIONALITY Internal, Hidden #> function Get-M365DSCApplicationInsightsTelemetryClient { [CmdletBinding()] param() if ($null -eq $Script:M365DSCTelemetryEngine) { $AI = "$PSScriptRoot/../Dependencies/Microsoft.ApplicationInsights.dll" [Reflection.Assembly]::LoadFile($AI) | Out-Null $TelClient = [Microsoft.ApplicationInsights.TelemetryClient]::new() $connectionString = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryConnectionString' if (-not [System.String]::IsNullOrEmpty($connectionString)) { $TelClient.TelemetryConfiguration.ConnectionString = $connectionString } else { $InstrumentationKey = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryInstrumentationKey' if ($null -eq $InstrumentationKey) { $InstrumentationKey = 'e670af5d-fd30-4407-a796-8ad30491ea7a' } $TelClient.InstrumentationKey = $InstrumentationKey } $Script:M365DSCTelemetryEngine = $TelClient } return $Script:M365DSCTelemetryEngine } <# .SYNOPSIS Stores LCM configuration metadata for telemetry enrichment. .DESCRIPTION Saves the Local Configuration Manager configuration object in module scope so telemetry events can include LCM context. .PARAMETER LCMConfig Specifies the Local Configuration Manager configuration object. .EXAMPLE PS> $lcmConfig = Get-DscLocalConfigurationManager PS> Set-M365DSCLCMConfiguration -LCMConfig $lcmConfig #> function Set-M365DSCLCMConfiguration { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.Object] $LCMConfig ) $Script:LCMConfig = $LCMConfig } <# .SYNOPSIS Sends a telemetry event to Application Insights. .DESCRIPTION Enriches telemetry data with runtime, environment, connection, and workload metadata, then submits the event through the telemetry client when telemetry is enabled. .PARAMETER Type Specifies the telemetry event type. .PARAMETER Data Specifies telemetry properties to include with the event. .PARAMETER Metrics Specifies numeric telemetry metrics to include with the event. .FUNCTIONALITY Internal #> function Add-M365DSCTelemetryEvent { [CmdletBinding()] param( [Parameter()] [System.String] $Type, [Parameter()] [System.Collections.Generic.Dictionary[[System.String], [System.Object]]] $Data, [Parameter()] [System.Collections.Generic.Dictionary[[System.String], [System.Double]]] $Metrics ) if (Test-IsM365DSCTelemetryEnabled) { try { $TelemetryClient = Get-M365DSCApplicationInsightsTelemetryClient } catch { Write-Verbose -Message "Could not create the telemetry client: $($_.Exception.Message)" return } $dataNew = [System.Collections.Generic.Dictionary[[System.String], [System.String]]]::new() foreach ($key in $Data.Keys) { if ($key -eq 'PSBoundParameters') { continue } $dataNew.Add($key, $Data[$key]) } if ($Type -eq 'DriftEvaluation') { try { $hostId = (Get-Host).InstanceId if ($null -eq $Script:M365DSCCountResourceInstance -or $hostId -ne $Script:M365DSCExecutionContextId) { $Script:M365DSCCountResourceInstance = 1 } else { $Script:M365DSCCountResourceInstance++ } if ($null -eq $Script:M365DSCOperationStartTime -or $hostId -ne $Script:M365DSCExecutionContextId) { $Script:M365DSCOperationStartTime = [System.DateTime]::Now } $Script:M365DSCOperationTimeTaken = [System.DateTime]::Now.Subtract($Script:M365DSCOperationStartTime) if ($hostId -ne $Script:M365DSCExecutionContextId) { $Script:M365DSCExecutionContextId = $hostId } $dataNew.Add('ResourceInstancesCount', $Script:M365DSCCountResourceInstance) $dataNew.Add('M365DSCExecutionContextId', $hostId) $dataNew.Add('M365DSCOperationTotalTime', $Script:M365DSCOperationTimeTaken.TotalSeconds) } catch { Write-Verbose -Message $_ } } try { $telemetryParameters = Get-M365DSCTelemetryConnectionParameter if ($null -eq $telemetryParameters -or $telemetryParameters.Count -eq 0) { $null = New-M365DSCConnection -Workload 'MicrosoftGraph' -InboundParameters $Data.PSBoundParameters } if ($null -ne $dataNew.ConnectionMode -and ` ($dataNew.ConnectionMode.StartsWith('Credential') -or $dataNew.ConnectionMode.StartsWith('ServicePrincipal'))) { if (-not $Script:M365DSCCurrentRolesResolved) { $Script:M365DSCCurrentRoles = @() $Script:M365DSCCurrentRolesResolved = $true try { $telemetryParameters = Get-M365DSCTelemetryConnectionParameter Connect-M365Tenant -Workload 'MicrosoftGraph' @telemetryParameters -ErrorAction Stop if ($dataNew.ConnectionMode.StartsWith('Credential')) { $uri = (Get-MSCloudLoginConnectionProfile -Workload MicrosoftGraph).ResourceUrl + 'v1.0/me?$select=id' $principalId = (Invoke-MgGraphRequest -Uri $uri -Method GET).id } else { $principalId = (Get-MgServicePrincipal -Filter "AppId eq '$($telemetryParameters.ApplicationId)'" ` -ErrorAction 'SilentlyContinue').Id } if (-not [System.String]::IsNullOrEmpty($principalId)) { $assignments = Get-MgBetaRoleManagementDirectoryRoleAssignment -Filter "principalId eq '$principalId'" ` -Property @('RoleDefinitionId', 'DirectoryScopeId') -ExpandProperty 'roleDefinition($select=displayName)' -All -ErrorAction 'SilentlyContinue' foreach ($assignment in $assignments) { if ($null -ne $assignment.RoleDefinition) { $Script:M365DSCCurrentRoles += $assignment.RoleDefinition.DisplayName + '|' + $assignment.DirectoryScopeId } } } } catch { Write-Verbose -Message $_ } } if ($Script:M365DSCCurrentRoles.Count -gt 0) { $dataNew.Add('M365DSCCurrentRoles', $Script:M365DSCCurrentRoles -join ',') } } } catch { Write-Verbose -Message $_ } try { $ProjectName = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryProjectName' if ($null -ne $ProjectName) { $dataNew.Add('ProjectName', $ProjectName) } if (-not $dataNew.ContainsKey('Tenant')) { if (-not [System.String]::IsNullOrEmpty($dataNew.Principal)) { if ($dataNew.Principal -like '*@*.*') { $principalValue = $dataNew.Principal.Split('@')[1] $dataNew.Add('Tenant', $principalValue) } } elseif (-not [System.String]::IsNullOrEmpty($dataNew.TenantId)) { $principalValue = $dataNew.TenantId $dataNew.Add('Tenant', $principalValue) } } $dataNew.Remove('TenantId') | Out-Null $dataNew.Remove('Principal') | Out-Null # Capture PowerShell Version Info if (-not $dataNew.Keys.Contains('PSMainVersion')) { $dataNew.Add('PSMainVersion', $PSVersionTable.PSVersion.Major.ToString() + '.' + $PSVersionTable.PSVersion.Minor.ToString()) } if (-not $dataNew.Keys.Contains('PSVersion')) { $dataNew.Add('PSVersion', $PSVersionTable.PSVersion.ToString()) } if (-not $dataNew.Keys.Contains('PSEdition')) { $dataNew.Add('PSEdition', $PSVersionTable.PSEdition.ToString()) } if ($null -ne $PSVersionTable.BuildVersion -and -not $dataNew.Keys.Contains('PSBuildVersion')) { $dataNew.Add('PSBuildVersion', $PSVersionTable.BuildVersion.ToString()) } if ($null -ne $PSVersionTable.CLRVersion -and -not $dataNew.Keys.Contains('PSCLRVersion')) { $dataNew.Add('PSCLRVersion', $PSVersionTable.CLRVersion.ToString()) } # Capture Console/Host Information if ($host.Name -eq 'ConsoleHost' -and $null -eq $env:WT_SESSION -and ` $null -ne $env:BUILD_BUILDID -and $env:SYSTEM_HOSTTYPE -eq 'build' -and -not $dataNew.Keys.Contains('PowerShellAgent')) { $dataNew.Add('PowerShellAgent', 'Azure DevOPS') $dataNew.Add('AzureDevOPSPipelineType', 'Build') $dataNew.Add('AzureDevOPSAgent', $env:POWERSHELL_DISTRIBUTION_CHANNEL) } elseif ($host.Name -eq 'ConsoleHost' -and $null -eq $env:WT_SESSION -and ` $null -ne $env:BUILD_BUILDID -and $env:SYSTEM_HOSTTYPE -eq 'release' -and -not $dataNew.Keys.Contains('PowerShellAgent')) { $dataNew.Add('PowerShellAgent', 'Azure DevOPS') $dataNew.Add('AzureDevOPSPipelineType', 'Release') $dataNew.Add('AzureDevOPSAgent', $env:POWERSHELL_DISTRIBUTION_CHANNEL) } elseif ($host.Name -eq 'ConsoleHost' -and $null -eq $env:WT_SESSION -and -not $dataNew.Keys.Contains('PowerShellAgent')) { $dataNew.Add('PowerShellAgent', 'Console') } elseif ($host.Name -eq 'Windows PowerShell ISE Host' -and -not $dataNew.Keys.Contains('PowerShellAgent')) { $dataNew.Add('PowerShellAgent', 'ISE') } elseif ($host.Name -eq 'ConsoleHost' -and $null -ne $env:WT_SESSION -and -not $dataNew.Keys.Contains('PowerShellAgent')) { $dataNew.Add('PowerShellAgent', 'Windows Terminal') } elseif ($host.Name -eq 'Default Host' -and ` $null -ne $env:APPSETTING_FUNCTIONS_EXTENSION_VERSION -and -not $dataNew.Keys.Contains('PowerShellAgent')) { $dataNew.Add('PowerShellAgent', 'Azure Function') $dataNew.Add('AzureFunctionWorkerVersion', $env:FUNCTIONS_WORKER_RUNTIME_VERSION) } elseif ($host.Name -eq 'CloudShell' -and -not $dataNew.Keys.Contains('PowerShellAgent')) { $dataNew.Add('PowerShellAgent', 'Cloud Shell') } if ($null -ne $dataNew.Resource -and $dataNew.Keys.Contains('Resource')) { $dataNew.Resource = $dataNew.Resource.Replace('MSFT_', '') foreach ($prefix in $Script:M365DSCTelemetryWorkloadNames.Keys) { if ($dataNew.Resource.StartsWith($prefix, [System.StringComparison]::Ordinal)) { $dataNew.Add('Workload', $Script:M365DSCTelemetryWorkloadNames[$prefix]) break } } } if ($Type -eq 'ExportCompleted') { if ($null -ne $Global:M365DSCExportResourceInstancesCount) { $dataNew.Add('ExportedResourceInstancesCount', $Global:M365DSCExportResourceInstancesCount) } if ($null -ne $Global:M365DSCExportResourceTypes) { $dataNew.Add('ExportedResourceTypes', $Global:M365DSCExportResourceTypes) $dataNew.Add('ExportedResourceTypesCount', $Global:M365DSCExportResourceTypes.Length) } if ($null -ne $Global:M365DSCExportContentSize) { $dataNew.Add('ExportedContentSize', $Global:M365DSCExportContentSize) } } [array]$version = (Get-Module 'Microsoft365DSC').Version | Sort-Object -Descending $dataNew.Add('M365DSCVersion', $version[0].ToString()) # OS Version try { if ($null -eq $Script:M365DSCOSInfo) { $Script:M365DSCOSInfo = (Get-CimInstance -ClassName Win32_OperatingSystem -Property Caption -ErrorAction SilentlyContinue -Verbose:$false).Caption } $dataNew.Add('M365DSCOSVersion', $Script:M365DSCOSInfo) } catch { Write-Verbose -Message $_ } # LCM Metadata Information try { if ($null -eq $Script:M365DSCCurrentPrincipalIsAdmin) { $Script:M365DSCCurrentPrincipalIsAdmin = Test-M365DSCCurrentUserIsAdministrator } if ($Script:M365DSCCurrentPrincipalIsAdmin) { if ($null -eq $Script:LCMInfo -or -not $Global:M365DSCExportInProgress) { $Script:LCMInfo = Get-DscLocalConfigurationManager -ErrorAction Stop } $certificateConfigured = $false if (-not [System.String]::IsNullOrEmpty($Script:LCMInfo.CertificateID)) { $certificateConfigured = $true } $partialConfiguration = $false if (-not [System.String]::IsNullOrEmpty($Script:LCMInfo.PartialConfigurations)) { $partialConfiguration = $true } $dataNew.Add('LCMUsesPartialConfigurations', $partialConfiguration) $dataNew.Add('LCMCertificateConfigured', $certificateConfigured) $dataNew.Add('LCMConfigurationMode', $Script:LCMInfo.ConfigurationMode) $dataNew.Add('LCMConfigurationModeFrequencyMins', $Script:LCMInfo.ConfigurationModeFrequencyMins) $dataNew.Add('LCMRefreshMode', $Script:LCMInfo.RefreshMode) $dataNew.Add('LCMState', $Script:LCMInfo.LCMState) $dataNew.Add('LCMStateDetail', $Script:LCMInfo.LCMStateDetail) if ([System.String]::IsNullOrEmpty($Type)) { if ($Global:M365DSCExportInProgress) { $Type = 'Export' } else { $Type = switch (ConvertTo-M365DSCLCMStateName -LCMStateDetail $Script:LCMInfo.LCMStateDetail) { 'ConsistencyCheck' { 'MonitoringScheduled' } 'ManualTestDSCConfiguration' { 'MonitoringManual' } 'Initial' { 'ApplyingConfiguration' } default { 'Undetermined' } } } } } } catch { Write-Verbose -Message $_ } $M365DSCTelemetryEventId = (New-Guid).ToString() $dataNew.Add('M365DSCTelemetryEventId', $M365DSCTelemetryEventId) if ([System.String]::IsNullOrEMpty($Type)) { if ((-not [System.String]::IsNullOrEmpty($dataNew.Method) -and $dataNew.Method -eq 'Export') -or $Global:M365DSCExportInProgress) { $Type = 'Export' } } $TelemetryClient.TrackEvent($Type, $dataNew, $Metrics) if ($Type -eq 'ExportCompleted') { $TelemetryClient.Flush() } } catch { try { $TelemetryClient.TrackEvent('Error', $dataNew, $Metrics) } catch { Write-Verbose -Message "Could not send telemetry: $($_.Exception.Message)" } } } } <# .SYNOPSIS Returns the telemetry values resolved in the current runspace. .DESCRIPTION Returns the directory roles, operating system caption, administrator flag and LCM settings that telemetry events add. A parallel export resolves them once and hands them to its workers. .OUTPUTS System.Collections.Hashtable #> function Get-M365DSCTelemetryContext { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param () return @{ CurrentRolesResolved = $Script:M365DSCCurrentRolesResolved CurrentRoles = $Script:M365DSCCurrentRoles OSInfo = $Script:M365DSCOSInfo CurrentPrincipalIsAdmin = $Script:M365DSCCurrentPrincipalIsAdmin LCMInfo = $Script:LCMInfo } } <# .SYNOPSIS Applies telemetry values resolved in another runspace. .PARAMETER Context Specifies the values returned by Get-M365DSCTelemetryContext. #> function Set-M365DSCTelemetryContext { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.Collections.Hashtable] $Context ) $Script:M365DSCCurrentRolesResolved = [System.Boolean]$Context.CurrentRolesResolved $Script:M365DSCCurrentRoles = @($Context.CurrentRoles) $Script:M365DSCOSInfo = $Context.OSInfo $Script:M365DSCCurrentPrincipalIsAdmin = $Context.CurrentPrincipalIsAdmin $Script:LCMInfo = $Context.LCMInfo } <# .SYNOPSIS Configures machine-scoped telemetry options. .DESCRIPTION Writes telemetry settings such as enabled state, instrumentation key, project name, and connection string to machine environment variables. .PARAMETER Enabled Specifies whether telemetry should be enabled. .PARAMETER InstrumentationKey Specifies the Application Insights instrumentation key. .PARAMETER ProjectName Specifies the telemetry project name value. .PARAMETER ConnectionString Specifies the Application Insights connection string. .EXAMPLE Set-M365DSCTelemetryOption -Enabled $false .FUNCTIONALITY Public #> function Set-M365DSCTelemetryOption { [CmdletBinding()] param( [Parameter()] [System.Boolean] $Enabled, [Parameter()] [System.String] $InstrumentationKey, [Parameter()] [System.String] $ProjectName, [Parameter()] [System.String] $ConnectionString ) if ($PSBoundParameters.ContainsKey('Enabled')) { Set-M365DSCTelemetrySetting -Name 'M365DSCTelemetryEnabled' -Value $Enabled $Script:TelemetryEnabled = $Enabled } if ($PSBoundParameters.ContainsKey('InstrumentationKey')) { Set-M365DSCTelemetrySetting -Name 'M365DSCTelemetryInstrumentationKey' -Value $InstrumentationKey $Script:M365DSCTelemetryEngine = $null } if ($PSBoundParameters.ContainsKey('ProjectName')) { Set-M365DSCTelemetrySetting -Name 'M365DSCTelemetryProjectName' -Value $ProjectName } if ($PSBoundParameters.ContainsKey('ConnectionString')) { Set-M365DSCTelemetrySetting -Name 'M365DSCTelemetryConnectionString' -Value $ConnectionString $Script:M365DSCTelemetryEngine = $null } } <# .SYNOPSIS Returns current machine-scoped telemetry configuration. .DESCRIPTION Reads telemetry-related environment variables and returns them as a hashtable. .EXAMPLE Get-M365DSCTelemetryOption .FUNCTIONALITY Public .OUTPUTS System.Collections.Hashtable #> function Get-M365DSCTelemetryOption { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param() return @{ Enabled = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryEnabled' InstrumentationKey = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryInstrumentationKey' ProjectName = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryProjectName' ConnectionString = Get-M365DSCTelemetrySetting -Name 'M365DSCTelemetryConnectionString' } } <# .SYNOPSIS Normalizes resource execution context into telemetry parameters. .DESCRIPTION Builds a telemetry dictionary from resource name, command name, and bound parameters. It resolves tenant and principal hints and includes authentication mode metadata. .PARAMETER ResourceName Specifies the resource name that produced the telemetry event. .PARAMETER CommandName Specifies the command or method name associated with the telemetry event. .PARAMETER Parameters Specifies bound parameters from the calling command. .FUNCTIONALITY Internal .OUTPUTS System.Collections.Generic.Dictionary[[System.String], [System.Object]] #> function Format-M365DSCTelemetryParameters { [CmdletBinding()] [OutputType([System.Collections.Generic.Dictionary[[System.String], [System.Object]]])] param( [parameter(Mandatory = $true)] [System.String] $ResourceName, [parameter(Mandatory = $true)] [System.String] $CommandName, [parameter(Mandatory = $true)] [System.Collections.Hashtable] $Parameters ) $data = [System.Collections.Generic.Dictionary[[System.String], [System.Object]]]::new() try { $data.Add('Resource', $ResourceName) $data.Add('Method', $CommandName) if ($Parameters.Credential) { try { $data.Add('Principal', $Parameters.Credential.UserName) $data.Add('Tenant', $Parameters.Credential.UserName.Split('@')[1]) } catch { Write-Verbose -Message $_ } } elseif ($Parameters.ApplicationId) { $data.Add('Principal', $Parameters.ApplicationId) $data.Add('Tenant', $Parameters.TenantId) } elseif (-not [System.String]::IsNullOrEmpty($Parameters.TenantId)) { $data.Add('Tenant', $Parameters.TenantId) } $connectionMode = Get-M365DSCAuthenticationMode -Parameters $Parameters $data.Add('ConnectionMode', $connectionMode) $data.Add('PSBoundParameters', $Parameters) } catch { Write-Verbose -Message $_ } return $data } Export-ModuleMember -Function @( 'Add-M365DSCTelemetryEvent', 'Format-M365DSCTelemetryParameters', 'Get-M365DSCTelemetryContext', 'Get-M365DSCTelemetryOption', 'Set-M365DSCTelemetryContext', 'Set-M365DSCTelemetryOption', 'Set-M365DSCLCMConfiguration', 'Test-IsM365DSCTelemetryEnabled' ) |