functions/Mde/machines/Set-MdMachineStartinvestigation.ps1

function Set-MdMachineStartinvestigation {
<#
.SYNOPSIS
    Actions - Start automated investigation on a machine
 
.DESCRIPTION
    Start automated investigation on a machine
 
.PARAMETER Comment
    A comment to associate to the investigation
 
.PARAMETER MachineID
    The ID of the machine to investigate
 
.EXAMPLE
    PS C:\> Set-MdMachineStartinvestigation -Comment $comment -MachineID $machineid
 
    Start automated investigation on a machine
 
.LINK
    <unknown>
#>

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '')]
    [CmdletBinding(DefaultParameterSetName = 'default')]
    param (
        [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true, ParameterSetName = 'default')]
        [string]
        $Comment,

        [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true, ParameterSetName = 'default')]
        [Alias('Id')]
        [string]
        $MachineID
    )
    process {
        $__mapping = @{
            'Comment' = 'Comment'
        }

        $__param = @{
            Body = $PSBoundParameters | ConvertTo-HashTable -Include @('Comment') -Mapping $__mapping
            Query = $PSBoundParameters | ConvertTo-HashTable -Include @() -Mapping $__mapping
            Header = $PSBoundParameters | ConvertTo-HashTable -Include @() -Mapping $__mapping
            Path = 'machines/{MachineID}/startInvestigation' -Replace '{MachineID}',$MachineID
            Method = 'post'
            
            
        }
        
        $__param += $PSBoundParameters | ConvertTo-HashTable -Include 'ErrorAction', 'WarningAction', 'Verbose'

        try { Invoke-DefenderAPIRequest @__param }
        catch { $PSCmdlet.ThrowTerminatingError($_) }
    }
}