Update-EndpointDevicesInHeat
SYNOPSIS
Update endpoint devices in Ivanti HEAT based on Intune data.
SYNTAX
Update-EndpointDevicesInHeat [[-ivantiInstance] <String>] [[-Logfile] <String>] [-Force] [-Computers] [-Other]
[[-CIName] <String>] [<CommonParameters>]
DESCRIPTION
This function connects to Ivanti and Microsoft Intune to retrieve device information, processes the data, and updates endpoint devices in Ivanti HEAT based on corresponding Intune managed devices. It supports filtering by device type and logs the operation details.
EXAMPLES
EXAMPLE 1
Updates computer devices in Ivanti HEAT using data from the "ivantiQA" instance.
EXAMPLE 2
Updates non-computer devices in Ivanti HEAT using data from the "ivantiPR" instance and logs the operation to the specified log file.
EXAMPLE 3
Updates the specific device "Device01" in Ivanti HEAT using data from the "ivantiDV" instance, forcing the update even if the device has not synced recently.
PARAMETERS
-ivantiInstance
The Ivanti instance to connect to. Valid values are "ivantiDV", "ivantiQA", and "ivantiPR". Default is "ivantiQA".
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: IvantiQA
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Logfile
The path to the log file where operation details will be recorded. Default is a timestamped log file in the Intune logs folder.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: ("\\stadgent\dumps\Logs\Intune\\$((Get-Date).toString('yyyyMMdd'))_Update-HeatCI.log")
Accept pipeline input: False
Accept wildcard characters: False
-Force
A switch to force processing of devices even if they have not synced recently.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Computers
A switch to process only computer devices.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Other
A switch to process non-computer devices (e.g., mobile devices).
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CIName
The name of the Configuration Item (CI) to process. If not provided, all matching devices are processed.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.