Skip to content

feat: add AVD device filtering with optional name‑based override #9

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tim-atkinson merged 3 commits into from
Jan 6, 2026
Merged

feat: add AVD device filtering with optional name‑based override #9

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
61c0741
t: add AVD device filtering with optional name‑based override
Dec 20, 2025
da682c7
docs: created CHANGELOG.md
Dec 20, 2025
cce6097
Fix: addressed Tim's feedback. Added , after
Handover2AI-byExistence Jan 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
## [1.2.0] - 2025-01-20
### Added
- Added -AVDDevices switch to filter Azure Virtual Desktop devices.
- Added -AVDUniqueIdentifier parameter to support name-based filtering.
26 changes: 26 additions & 0 deletions Export-IntuneManagedDevices.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,12 @@ param (
[Parameter(ParameterSetName = 'Interactive', Mandatory = $true)]
[switch]$UseInteractiveLogin,

[Parameter()]
[switch]$AVDDevices,

[Parameter()]
[string]$AVDUniqueIdentifier,

[string]$LogPath = "$PSScriptRoot\IntuneManagedDevices.log",
[string]$OutputDirectory = $PSScriptRoot
)
Expand Down Expand Up @@ -139,6 +145,26 @@ function Get-IntuneDevices {
# Retrieve all managed devices from Microsoft Intune
$Devices = Get-MgDeviceManagementManagedDevice -All
Write-Log -Message "Retrieved $($Devices.Count) devices from Microsoft Intune."

# Apply AVD multi-session filter if requested
if ($AVDDevices) {
Write-Log -Message "Filtering for AVD multi/single session devices..."

if ($AVDUniqueIdentifier) {
Write-Log -Message "Using device name identifier '$AVDUniqueIdentifier' for filtering."
$Devices = $Devices | Where-Object {
$_.deviceName -like "*$AVDUniqueIdentifier*"
}
}
else {
Write-Log -Message "Using default filter: model = 'Virtual Machine'"
$Devices = $Devices | Where-Object {
$_.model -eq "Virtual Machine"
}
}
Write-Log -Message "Filtered device count: $($Devices.Count)"
}

# Filter out any devices without a device name
return $Devices
}
Expand Down
22 changes: 21 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ This script connects to Microsoft Intune using the Microsoft Graph API to retrie
- Retrieves detailed information about managed devices in your Intune environment.
- Exports device data to **JSON** and **CSV** formats for further processing and analysis.
- Includes logging for transparency and troubleshooting.
- Optional AVD-specific filtering using `-AVDDevices` and `-AVDUniqueIdentifier` parameters.

## Requirements
- **Microsoft Graph SDK Installation**: Install the Microsoft Graph SDK by using the following command:
Expand Down Expand Up @@ -49,6 +50,13 @@ This script connects to Microsoft Intune using the Microsoft Graph API to retrie
- `-UseInteractiveLogin`: Use this switch for interactive user login instead of client credentials.
- `-LogPath`: The file path where logs should be written. Default is `IntuneDeviceSync.log` in the script's root directory.
- `-OutputDirectory`: Directory where output files (JSON and CSV) will be saved. Default is the script's root directory.
- `-AVDDevices` : Enables filtering for Azure Virtual Desktop devices (both single‑session and multi‑session).
- When enabled, the script filters devices using one of the methods:
- **Default :** model="Virtual Machine"</br>
Captures all Azure-based VMs entolled in Intune. They are very likely to be AVD devices.
- **Override :** device name identifier</br>
If `-AVDUniqueIdentifier` is provided, the script filters devices whose names contain the specified string.
- `AVDUniqueIdentifier` : Optional string used to filter AVD devices by name pattern (e.g., `"AVD"`, `"POOL"`, `"SESSION"`).

## Usage

Expand All @@ -64,9 +72,21 @@ This command will use the specified Client ID, Tenant ID, and Client Secret to a
```
This command will prompt you to log in interactively using your user credentials.

### Example 3: Export Only AVD Devices (Default Model Filter)
```powershell
.\Export-IntuneManagedDevices.ps1 -UseInteractiveLogin -AVDDevices
```

### Example 4: Export Only AVD Devices Using Name Identifier
```powershell
.\Export-IntuneManagedDevices.ps1 -UseInteractiveLogin -AVDDevices -AVDUniqueIdentifier "AVD"
```

## Script Details
- **Logging**: The script logs all activities, including authentication attempts, data retrieval, and export status, in a log file (`IntuneDeviceSync.log`). This helps in auditing and troubleshooting issues.
- **Data Filtering**: The script filters out devices that do not have a `deviceName` property set.
- **Data Filtering**
- The script filters out devices that do not have a `deviceName` property set.
- When `-AVDDevices` is used, additional filtering is applied.
- **Export**: The retrieved data is exported in two formats:
- **JSON**: Contains device details such as `deviceName`, `id`, `model`, and `lastSyncDateTime`.
- **CSV**: Contains similar information to the JSON output for easy viewing and processing.
Expand Down
Loading