Get-vmGuestExchange.ps1

Function
ConvertFrom-RawXml
{
    [System.Management.Automation.CmdletBindingAttribute()]
    Param(
        [System.Management.Automation.ParameterAttribute(
            Mandatory        = $True
        )]
        [System.String[]]
        $String
    )

    Process
    {
        $Instance = [System.Collections.Generic.List[System.Xml.XmlElement]]::new()

        $xml = [System.Xml.XmlDocument]::new()

        $String | ForEach-Object -Process {
            $xml.LoadXml( $psItem )
            $Instance.Add( $xml.INSTANCE )
        }

        Return $Instance
    }
}

Function
ConvertFrom-XmlInstance
{
    [System.Management.Automation.CmdletBindingAttribute()]
    Param(
        [System.Management.Automation.ParameterAttribute(
            Mandatory        = $True
        )]
        [System.Xml.XmlElement[]]
        $XmlInstance
    )

    Process
    {
        $Property = [System.Collections.Generic.List[
            System.Collections.Generic.Dictionary[
                System.String,
                System.String
            ]
        ]]::new()

        $XmlInstance | ForEach-Object -Process {

            $PropertyCurrent = [System.Collections.Generic.Dictionary[
                System.String,
                System.String
            ]]::new()

            $psItem.Property | ForEach-Object -Process {
                $PropertyCurrent.Add(
                    $psItem.Name,
                    $psItem.Value
                 )
            }

            $Property.Add( $PropertyCurrent )
        }

        Return $Property
    }
}

Function
ConvertFrom-CimProperty
{
    [System.Management.Automation.CmdletBindingAttribute()]
    Param(
        [System.Management.Automation.ParameterAttribute(
            Mandatory        = $True
        )]
        [System.Collections.Generic.List[
            System.Collections.Generic.Dictionary[
                System.String,
                System.String
            ]
        ]]
        $Property
    )

    Process
    {
        $Dictionary = [System.Collections.Generic.Dictionary[
            System.String,
            System.String
        ]]::new()

        $Property | ForEach-Object -Process {

            $Dictionary.Add( $psItem.Name, $psItem.Data )
        }

        Return $Dictionary
    }
}

Function
Get-vmGuestExchange
{
    [System.Management.Automation.CmdletBindingAttribute()]
    Param(
        [System.Management.Automation.ParameterAttribute(
            Mandatory        = $True
        )]
        [Microsoft.HyperV.PowerShell.VirtualMachine[]]
        $vm
    ,
        [System.Management.Automation.ParameterAttribute()]
        [System.Management.Automation.SwitchParameter]
        $Intrinsic 
    )

    Process
    {
        $Exchange = [System.Collections.Generic.List[
            System.Collections.Generic.Dictionary[
                System.String,
                System.String
            ]
        ]]::new()

        $vm | ForEach-Object -Process {

            $Filter = "ElementName = '$( $psItem.Name )'"

            $InstanceParam = @{
            
                CimSession = $psItem.CimSession
              # https://docs.microsoft.com/windows/win32/hyperv_v2/msvm-computersystem
                ClassName  = 'msvm_ComputerSystem'
                Namespace  = 'root/Virtualization/v2'
                Filter     = $Filter
            }
            $ComputerSystem       = Get-CimInstance @InstanceParam

            $AssociatedInstanceParam = @{
            
                InputObject     = $ComputerSystem
              # https://docs.microsoft.com/windows/win32/hyperv_v2/msvm-systemdevice
                Association     = 'msvm_SystemDevice'
              # https://docs.microsoft.com/windows/win32/hyperv_v2/msvm-kvpexchangecomponent
                ResultClassName = 'msvm_KvpExchangeComponent'
            }
            $KvpExchangeComponent = Get-CimAssociatedInstance @AssociatedInstanceParam
            
          # Deserialize CIM instances from XML

            If
            (
                $Intrinsic
            )
            {
                $String = $KvpExchangeComponent.GuestIntrinsicExchangeItems
            }
            Else
            {
                $String = $KvpExchangeComponent.GuestExchangeItems
            }

            $Instance = ConvertFrom-RawXml -String $String | Where-Object -FilterScript {
              # https://docs.microsoft.com/windows/win32/hyperv_v2/msvm-kvpexchangedataitem
                $psItem.ClassName -eq 'msvm_KvpExchangeDataItem'
            }

          # Parse instance structure and extract all properties
            $Property = [System.Collections.Generic.List[
                System.Collections.Generic.Dictionary[
                    System.String,
                    System.String
                ]
            ]]::new()
            
            ConvertFrom-XmlInstance -XmlInstance $Instance | ForEach-Object -Process {
                $Property.Add( $psItem )
            }
            
          # Select only the properties we need
            $Exchange.Add( ( ConvertFrom-CimProperty -Property $Property ) )
        }

        Return $Exchange
    }
}