DSCResources/MSFT_PlannerTask/MSFT_PlannerTask.psm1
|
function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [System.String] $PlanId, [Parameter(Mandatory = $true)] [System.String] $Title, [Parameter()] [System.String[]] $AssignedUsers, [Parameter()] [System.String] $Notes, [Parameter()] [System.String] $Bucket, [Parameter()] [System.String] $TaskId, [Parameter()] [System.String] $StartDateTime, [Parameter()] [System.String] $DueDateTime, [Parameter()] [ValidateSet('Pink', 'Red', 'Yellow', 'Green', 'Blue', 'Purple')] [System.String[]] $Categories, [Parameter()] [Microsoft.Management.Infrastructure.CimInstance[]] $Attachments, [Parameter()] [Microsoft.Management.Infrastructure.CimInstance[]] $Checklist, [Parameter()] [ValidateRange(0, 100)] [System.Uint32] $PercentComplete, [Parameter()] [ValidateRange(0, 10)] [System.UInt32] $Priority, [Parameter()] [System.String] $ConversationThreadId, [Parameter()] [System.String] [ValidateSet('Present', 'Absent')] $Ensure = 'Present', [Parameter()] [System.Management.Automation.PSCredential] $Credential, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $ApplicationSecret, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [Switch] $ManagedIdentity ) Write-Verbose -Message "Getting configuration of Planner Task {$Title}" #Ensure the proper dependencies are installed in the current environment. Confirm-M365DSCDependencies #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName -replace 'MSFT_', '' $CommandName = $MyInvocation.MyCommand $data = Format-M365DSCTelemetryParameters -ResourceName $ResourceName ` -CommandName $CommandName ` -Parameters $PSBoundParameters Add-M365DSCTelemetryEvent -Data $data #endregion $nullReturn = $PSBoundParameters $nullReturn.Ensure = 'Absent' try { $ConnectionMode = New-M365DSCConnection -Workload 'MicrosoftGraph' ` -InboundParameters $PSBoundParameters # If no TaskId were passed, automatically assume that this is a new task; if ([System.String]::IsNullOrEmpty($TaskId)) { return $nullReturn } $taskResponse = Get-MgPlannerTask -PlannerTaskId $TaskId $taskDetailsResponse = Get-MgPlannerTaskDetail -PlannerTaskId $taskResponse.Id #region Assignments $assignmentsValue = @() if ($null -ne $taskResponse.Assignments) { foreach ($assignmentKey in $taskResponse.Assignments.AdditionalProperties.Keys) { $assignedUser = Get-MgUser -UserId $assignmentKey $assignmentsValue += $assignedUser.UserPrincipalName } } #endregion #region Attachments $attachmentsValue = @() if ($null -ne $taskDetailsResponse.References) { foreach ($attachment in $taskDetailsResponse.References.AdditionalProperties.Keys) { $entry = $taskDetailsResponse.References.AdditionalProperties."$attachment" $hashEntry = @{ Uri = $attachment Alias = $entry.alias Type = $entry.type } $attachmentsValue += $hashEntry } } #endregion #region Categories $categoriesValue = @() if ($null -ne $taskResponse.appliedCategories) { foreach ($category in $taskResponse.appliedCategories.AdditionalProperties.Keys) { $categoriesValue += GetTaskColorNameByCategory($category) } } #endregion #region Checklist $checklistValue = @() if ($null -ne $taskDetailsResponse.CheckList) { foreach ($checkListItem in $taskDetailsResponse.CheckList.AdditionalProperties.Keys) { $hashEntry = @{ Title = $taskDetailsResponse.CheckList.AdditionalProperties."$checkListItem".title Completed = [bool]$taskDetailsResponse.CheckList.AdditionalProperties."$checkListItem".isChecked } $checklistValue += $hashEntry } } #endregion if ($null -eq $taskResponse) { return $nullReturn } else { $NotesValue = '' if (-not [System.String]::IsNullOrEmpty($taskResponse)) { $NotesValue = $taskDetailsResponse.Description } $StartDateTimeValue = $null if ($null -ne $taskResponse.StartDateTime) { $StartDateTimeValue = $taskResponse.StartDateTime } $DueDateTimeValue = $null if ($null -ne $taskResponse.DueDateTime) { $DueDateTimeValue = $taskResponse.DueDateTime } $results = @{ PlanId = $PlanId Title = $Title AssignedUsers = $assignmentsValue TaskId = $taskResponse.Id Categories = $categoriesValue Attachments = $attachmentsValue Checklist = $checklistValue Bucket = $taskResponse.BucketId Priority = $taskResponse.Priority ConversationThreadId = $taskResponse.ConversationThreadId PercentComplete = $taskResponse.PercentComplete StartDateTime = $StartDateTimeValue DueDateTime = $DueDateTimeValue Notes = $NotesValue Ensure = 'Present' Credential = $Credential ApplicationId = $ApplicationId TenantId = $TenantId CertificateThumbprint = $CertificateThumbprint ApplicationSecret = $ApplicationSecret ManagedIdentity = $ManagedIdentity.IsPresent } Write-Verbose -Message "Get-TargetResource Result: `n $(Convert-M365DscHashtableToString -Hashtable $results)" return $results } } catch { New-M365DSCLogEntry -Message 'Error retrieving data:' ` -Exception $_ ` -Source $($MyInvocation.MyCommand.Source) ` -TenantId $TenantId ` -Credential $Credential return $nullReturn } } function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $PlanId, [Parameter(Mandatory = $true)] [System.String] $Title, [Parameter()] [System.String[]] $AssignedUsers, [Parameter()] [System.String] $Notes, [Parameter()] [System.String] $Bucket, [Parameter()] [System.String] $TaskId, [Parameter()] [System.String] $StartDateTime, [Parameter()] [System.String] $DueDateTime, [Parameter()] [ValidateSet('Pink', 'Red', 'Yellow', 'Green', 'Blue', 'Purple')] [System.String[]] $Categories, [Parameter()] [Microsoft.Management.Infrastructure.CimInstance[]] $Attachments, [Parameter()] [Microsoft.Management.Infrastructure.CimInstance[]] $Checklist, [Parameter()] [ValidateRange(0, 100)] [System.Uint32] $PercentComplete, [Parameter()] [ValidateRange(0, 10)] [System.UInt32] $Priority, [Parameter()] [System.String] $ConversationThreadId, [Parameter()] [System.String] [ValidateSet('Present', 'Absent')] $Ensure = 'Present', [Parameter()] [System.Management.Automation.PSCredential] $Credential, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $ApplicationSecret, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [Switch] $ManagedIdentity ) Write-Verbose -Message "Setting configuration of Planner Task {$Title}" #Ensure the proper dependencies are installed in the current environment. Confirm-M365DSCDependencies #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName -replace 'MSFT_', '' $CommandName = $MyInvocation.MyCommand $data = Format-M365DSCTelemetryParameters -ResourceName $ResourceName ` -CommandName $CommandName ` -Parameters $PSBoundParameters Add-M365DSCTelemetryEvent -Data $data #endregion $ConnectionMode = New-M365DSCConnection -Workload 'MicrosoftGraph' ` -InboundParameters $PSBoundParameters $currentValues = Get-TargetResource @PSBoundParameters $setParams = ([HashTable]$PSBoundParameters).Clone() $setParams.Remove('Ensure') | Out-Null $setParams.Remove('Credential') | Out-Null $setParams.Remove('ApplicationId') | Out-Null $setParams.Remove('TenantId') | Out-Null $setParams.Remove('CertificateThumbprint') | Out-Null $setParams.Remove('ApplicationSecret') | Out-Null #region Assignments Write-Verbose -Message 'Converting Assignments into the proper format' $assignmentsValue = @{} foreach ($assignment in $setParams.AssignedUsers) { $user = Get-MgUser -UserId $assignment -ErrorAction SilentlyContinue if ($null -ne $user) { $currentValue += @{ '@odata.type' = '#microsoft.graph.plannerAssignment' orderHint = ' !' } $assignmentsValue.Add($user.Id, $currentValue) } } $setParams.Assignments = $assignmentsValue $setParams.Remove('AssignedUsers') | Out-Null #endregion $DetailsValue = @{ id = (New-Guid).ToString() checklist = @() description = $Notes references = @() } #region CheckList $checklistValues = @{} foreach ($checkListItem in $setParams.Checklist) { $currentValue = @{ '@odata.type' = '#microsoft.graph.plannerChecklistItem' isChecked = $checkListItem.Completed title = $checkListItem.Title } $checkListValues.Add((New-Guid).ToString(), $currentValue) } $DetailsValue.checklist = $checkListValues $setParams.Remove('Checklist') | Out-Null #endregion #region Attachments $attachmentsValues = @{} foreach ($attachment in $setParams.Attachments) { $currentValue = @{ '@odata.type' = '#microsoft.graph.plannerExternalReference' alias = $attachment.Alias type = $attachment.Type } $attachmentsValues.Add($attachment.Uri, $currentValue) } $DetailsValue.references = $attachmentsValues $setParams.Remove('Attachments') | Out-Null #endregion $setParams.Remove('Description') | Out-Null $setParams.Add('Details', $DetailsValue) $setParams.Remove('Notes') | Out-Null #region Categories $categoriesValue = @{ category1 = $false category2 = $false category3 = $false category4 = $false category5 = $false category6 = $false } foreach ($category in $setParams.Categories) { $categoriesValue.(GetTaskCategoryNameByColor($category)) = $true } $setParams.Add('AppliedCategories', $categoriesValue) $setParams.Remove('Categories') | Out-Null #endregion $setParams.Add('BucketId', $setParams.Bucket) $setParams.Remove('Bucket') | Out-Null if ($Ensure -eq 'Present' -and $currentValues.Ensure -eq 'Absent') { $setParams.Remove('TaskId') | Out-Null Write-Verbose -Message "Planner Task {$Title} doesn't already exist. Creating it with`r`n:$(Convert-M365DscHashtableToString -Hashtable $setParams)" $newTask = New-MgPlannerTask @setParams } elseif ($Ensure -eq 'Present' -and $currentValues.Ensure -eq 'Present') { $taskId = $setParams.TaskId $setParams.Remove('TaskId') | Out-Null $details = $setParams.Details $setParams.Remove('Details') | Out-Null $setParams.Remove('Verbose') | Out-Null # Fix Casing $setParams.Add('assignments', $setParams.Assignments) $setParams.Remove('Assignments') | Out-Null $setParams.Add('appliedCategories', $setParams.AppliedCategories) $setParams.Remove('AppliedCategories') | Out-Null $setParams.Add('title', $setParams.Title) $setParams.Remove('Title') | Out-Null $setParams.Add('bucketId', $setParams.BucketId) $setParams.Remove('BucketId') | Out-Null $setParams.Add('dueDateTime', [DateTime]::Parse($setParams.DueDateTime).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ss.fffK')) $setParams.Remove('DueDateTime') | Out-Null $setParams.Add('percentComplete', $setParams.PercentComplete) $setParams.Remove('PercentComplete') | Out-Null $setParams.Remove('PlanId') | Out-Null $setParams.Add('priority', $setParams.Priority) $setParams.Remove('Priority') | Out-Null $setParams.Add('startDateTime', [DateTime]::Parse($setParams.StartDateTime).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ss.fffK')) $setParams.Remove('StartDateTime') | Out-Null Write-Verbose -Message "Planner Task {$Title} already exists, but is not in the ` Desired State. Updating it." $currentTask = Get-MgPlannerTask -PlannerTaskId $taskId $Headers = @{} $etag = $currentTask.AdditionalProperties.'@odata.etag' $Headers.Add('If-Match', $etag) $JSONDetails = (ConvertTo-Json $setParams) Write-Verbose -Message "Updating Task with:`r`n$JSONDetails" # Need to continue to rely on Invoke-MgGraphRequest Invoke-MgGraphRequest -Method PATCH ` -Uri "https://graph.microsoft.com/v1.0/planner/tasks/$taskId" ` -Headers $Headers ` -Body $JSONDetails # Update Details $Headers = @{} $currentTaskDetails = Get-MgPlannerTaskDetail -PlannerTaskId $taskId $Headers.Add('If-Match', $currentTaskDetails.AdditionalProperties.'@odata.etag') $details.Remove('id') | Out-Null $JSONDetails = (ConvertTo-Json $details) Write-Verbose -Message "Updating Task's details with:`r`n$JSONDetails" Invoke-MgGraphRequest -Method PATCH ` -Uri "https://graph.microsoft.com/v1.0/planner/tasks/$taskId/details" ` -Headers $Headers ` -Body $JSONDetails #endregion } elseif ($Ensure -eq 'Absent' -and $currentValues.Ensure -eq 'Present') { Write-Verbose -Message "Planner Task {$Title} exists, but is should not. ` Removing it." Remove-MgPlannerTask -PlannerTaskId $setParams.TaskId } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [System.String] $PlanId, [Parameter(Mandatory = $true)] [System.String] $Title, [Parameter()] [System.String[]] $AssignedUsers, [Parameter()] [System.String] $Notes, [Parameter()] [System.String] $Bucket, [Parameter()] [System.String] $TaskId, [Parameter()] [System.String] $StartDateTime, [Parameter()] [System.String] $DueDateTime, [Parameter()] [ValidateSet('Pink', 'Red', 'Yellow', 'Green', 'Blue', 'Purple')] [System.String[]] $Categories, [Parameter()] [Microsoft.Management.Infrastructure.CimInstance[]] $Attachments, [Parameter()] [Microsoft.Management.Infrastructure.CimInstance[]] $Checklist, [Parameter()] [ValidateRange(0, 100)] [System.Uint32] $PercentComplete, [Parameter()] [ValidateRange(0, 10)] [System.UInt32] $Priority, [Parameter()] [System.String] $ConversationThreadId, [Parameter()] [System.String] [ValidateSet('Present', 'Absent')] $Ensure = 'Present', [Parameter()] [System.Management.Automation.PSCredential] $Credential, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $ApplicationSecret, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [Switch] $ManagedIdentity ) #Ensure the proper dependencies are installed in the current environment. Confirm-M365DSCDependencies #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName -replace 'MSFT_', '' $CommandName = $MyInvocation.MyCommand $data = Format-M365DSCTelemetryParameters -ResourceName $ResourceName ` -CommandName $CommandName ` -Parameters $PSBoundParameters Add-M365DSCTelemetryEvent -Data $data #endregion Write-Verbose -Message "Testing configuration of Planner Task {$Title}" $CurrentValues = Get-TargetResource @PSBoundParameters Write-Verbose -Message "Target Values: $(Convert-M365DscHashtableToString -Hashtable $PSBoundParameters)" $ValuesToCheck = $PSBoundParameters # If the Task is currently assigned to a bucket and the Bucket property is null, # assume that we are trying to remove the given task from the bucket and therefore # treat this as a drift. if ([System.String]::IsNullOrEmpty($Bucket) -and ` -not [System.String]::IsNullOrEmpty($CurrentValues.Bucket)) { $TestResult = $false } else { $ValuesToCheck.Remove('Checklist') | Out-Null if (-not (Test-M365DSCPlannerTaskCheckListValues -CurrentValues $CurrentValues ` -DesiredValues $ValuesToCheck)) { return $false } $TestResult = Test-M365DSCParameterState -CurrentValues $CurrentValues ` -Source $($MyInvocation.MyCommand.Source) ` -DesiredValues $PSBoundParameters ` -ValuesToCheck $ValuesToCheck.Keys } Write-Verbose -Message "Test-TargetResource returned $TestResult" return $TestResult } function Export-TargetResource { [CmdletBinding()] [OutputType([System.String])] param ( [Parameter()] [System.String] $Filter, [Parameter()] [System.Management.Automation.PSCredential] $Credential, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $ApplicationSecret, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [Switch] $ManagedIdentity ) #Ensure the proper dependencies are installed in the current environment. Confirm-M365DSCDependencies #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName -replace 'MSFT_', '' $CommandName = $MyInvocation.MyCommand $data = Format-M365DSCTelemetryParameters -ResourceName $ResourceName ` -CommandName $CommandName ` -Parameters $PSBoundParameters Add-M365DSCTelemetryEvent -Data $data #endregion try { $ConnectionMode = New-M365DSCConnection -Workload 'MicrosoftGraph' ` -InboundParameters $PSBoundParameters [array]$groups = Get-MgGroup -All:$true -ErrorAction Stop -Filter $filter $i = 1 $dscContent = '' Write-Host "`r`n" -NoNewline foreach ($group in $groups) { Write-Host " |---[$i/$($groups.Length)] $($group.DisplayName) - {$($group.Id)}" try { [Array]$plans = Get-MgGroupPlannerPlan -GroupId $group.Id -ErrorAction 'SilentlyContinue' $j = 1 foreach ($plan in $plans) { Write-Host " |---[$j/$($plans.Length)] $($plan.Title)" [Array]$tasks = Get-MgGroupPlannerPlanTask -GroupId $group.Id -PlannerPlanId $plan.Id -ErrorAction 'SilentlyContinue' $k = 1 foreach ($task in $tasks) { Write-Host " |---[$k/$($tasks.Length)] $($task.Title)" -NoNewline $currentDSCBlock = '' $params = @{ TaskId = $task.Id PlanId = $plan.Id Title = $task.Title Credential = $Credential ApplicationId = $ApplicationId TenantId = $TenantId CertificateThumbprint = $CertificateThumbprint ApplicationSecret = $ApplicationSecret ManagedIdentity = $ManagedIdentity.IsPresent } $result = Get-TargetResource @params if ($result.AssignedUsers.Count -eq 0) { $result.Remove('AssignedUsers') | Out-Null } $result = Update-M365DSCExportAuthenticationResults -ConnectionMode $ConnectionMode ` -Results $Result if ($result.Attachments.Length -gt 0) { $result.Attachments = Convert-M365DSCPlannerTaskAssignmentToCIMArray -Attachments $result.Attachments } else { $result.Remove('Attachments') | Out-Null } if ($result.Checklist.Length -gt 0) { $result.Checklist = Convert-M365DSCPlannerTaskChecklistToCIMArray -Checklist $result.Checklist } else { $result.Remove('Checklist') | Out-Null } # Fix Notes which can have multiple lines if (-not [System.String]::IsNullOrEmpty($result.Notes)) { $result.Notes = $result.Notes.Replace('"', '``"') $result.Notes = $result.Notes.Replace('&', "``&") } $currentDSCBlock = Get-M365DSCExportContentForResource -ResourceName $ResourceName ` -ConnectionMode $ConnectionMode ` -ModulePath $PSScriptRoot ` -Results $result ` -Credential $Credential if ($result.Attachments.Length -gt 0) { $currentDSCBlock = Convert-DSCStringParamToVariable -DSCBlock $currentDSCBlock ` -ParameterName 'Attachments' } if ($result.Checklist.Length -gt 0) { $currentDSCBlock = Convert-DSCStringParamToVariable -DSCBlock $currentDSCBlock ` -ParameterName 'Checklist' } $dscContent += $currentDSCBlock Save-M365DSCPartialExport -Content $currentDSCBlock ` -FileName $Global:PartialExportFileName $k++ Write-Host $Global:M365DSCEmojiGreenCheckmark } $j++ } } catch { Write-Host $Global:M365DSCEmojiRedX New-M365DSCLogEntry -Message 'Error during Export:' ` -Exception $_ ` -Source $($MyInvocation.MyCommand.Source) ` -TenantId $TenantId ` -Credential $Credential } $i++ } return $dscContent } catch { Write-Host $Global:M365DSCEmojiRedX New-M365DSCLogEntry -Message 'Error during Export:' ` -Exception $_ ` -Source $($MyInvocation.MyCommand.Source) ` -TenantId $TenantId ` -Credential $Credential return '' } } function Test-M365DSCPlannerTaskCheckListValues { [CmdletBinding()] [OutputType([System.Boolean])] Param( [Parameter(Mandatory = $true)] [System.Collections.HashTable[]] $CurrentValues, [Parameter(Mandatory = $true)] [System.Collections.HashTable[]] $DesiredValues ) # Check in CurrentValues for item that don't exist or are different in # the DesiredValues; foreach ($checklistItem in $CurrentValues) { $equivalentItemInDesired = $DesiredValues | Where-Object -FilterScript { $_.Title -eq $checklistItem.Title } if ($null -eq $equivalentItemInDesired -or ` $checklistItem.Completed -ne $equivalentItemInDesired.Completed) { return $false } } # Do the opposite, check in DesiredValue for item that don't exist or are different in # the CurrentValues; foreach ($checklistItem in $DesiredValues) { $equivalentItemInCurrent = $CurrentValues | Where-Object -FilterScript { $_.Title -eq $checklistItem.Title } if ($null -eq $equivalentItemInCurrent -or ` $checklistItem.Completed -ne $equivalentItemInCurrent.Completed) { return $false } } return $true } function Convert-M365DSCPlannerTaskAssignmentToCIMArray { [CmdletBinding()] [OutputType([System.String[]])] Param( [Parameter(Mandatory = $true)] [System.Collections.HashTable[]] $Attachments ) $stringContent = "@(`r`n" foreach ($attachment in $Attachments) { $stringContent += " MSFT_PlannerTaskAttachment`r`n" $stringContent += " {`r`n" $stringContent += " Uri = '$($attachment.Uri.Replace("'", "''"))'`r`n" $stringContent += " Alias = '$($attachment.Alias.Replace("'", "''"))'`r`n" $stringContent += " Type = '$($attachment.Type)'`r`n" $StringContent += " }`r`n" } $StringContent += ' )' return $StringContent } function Convert-M365DSCPlannerTaskChecklistToCIMArray { [CmdletBinding()] [OutputType([System.String[]])] Param( [Parameter(Mandatory = $true)] [System.Collections.HashTable[]] $Checklist ) $stringContent = "@(`r`n" foreach ($checklistItem in $Checklist) { $stringContent += " MSFT_PlannerTaskChecklistItem`r`n" $stringCOntent += " {`r`n" $stringContent += " Title = '$($checklistItem.Title.Replace("'", "''"))'`r`n" $stringContent += " Completed = `$$($checklistItem.Completed.ToString())`r`n" $StringContent += " }`r`n" } $StringContent += ' )' return $StringContent } function Get-M365DSCPlannerPlansFromGroup { [CmdletBinding()] [OutputType([System.Collections.Hashtable[]])] Param( [Parameter(Mandatory = $true)] [System.String] $GroupId, [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $Credential ) $results = @() $uri = "https://graph.microsoft.com/v1.0/groups/$GroupId/planner/plans" $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -CloudCredential $Credential ` -Uri $uri ` -Method Get foreach ($plan in $taskResponse.value) { $results += @{ Id = $plan.id Title = $plan.title } } return $results } function Get-M365DSCPlannerTasksFromPlan { [CmdletBinding()] [OutputType([System.Collections.Hashtable[]])] Param( [Parameter(Mandatory = $true)] [System.String] $PlanId, [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $Credential ) $results = @() $uri = "https://graph.microsoft.com/v1.0/planner/plans/$PlanId/tasks" $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method Get foreach ($task in $taskResponse.value) { $results += @{ Title = $task.title Id = $task.id } } return $results } function GetTaskCategoryNameByColor { [CmdletBinding()] [OutputType([System.string])] param( [Parameter(Mandatory = $true)] [System.String] $ColorName ) switch ($ColorName) { 'Pink' { return 'category1' } 'Red' { return 'category2' } 'Yellow' { return 'category3' } 'Green' { return 'category4' } 'Blue' { return 'category5' } 'Purple' { return 'category6' } } return $null } function GetTaskColorNameByCategory { [CmdletBinding()] [OutputType([System.string])] param( [Parameter(Mandatory = $true)] [System.String] $CategoryName ) switch ($CategoryName) { 'category1' { return 'Pink' } 'category2' { return 'Red' } 'category3' { return 'Yellow' } 'category4' { return 'Green' } 'category5' { return 'Blue' } 'category6' { return 'Purple' } } return $null } Export-ModuleMember -Function *-TargetResource |