Public/Invoke-IntuneRestoreDeviceConfiguration.ps1
|
function Invoke-IntuneRestoreDeviceConfiguration { <# .SYNOPSIS Restore Intune Device Configurations .DESCRIPTION Restore Intune Device Configurations from JSON files per Device Configuration Policy from the specified Path. .PARAMETER Path Root path where backup files are located, created with the Invoke-IntuneBackupDeviceConfigurations function .EXAMPLE Invoke-IntuneRestoreDeviceConfiguration -Path "C:\temp" -RestoreById $true #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$Path, [Parameter(Mandatory = $false)] [ValidateSet("v1.0", "Beta")] [string]$ApiVersion = "Beta" ) # Set the Microsoft Graph API endpoint if (-not ((Get-MSGraphEnvironment).SchemaVersion -eq $apiVersion)) { Update-MSGraphEnvironment -SchemaVersion $apiVersion -Quiet Connect-MSGraph -ForceNonInteractive -Quiet } # Get all device configurations $deviceConfigurations = Get-ChildItem -Path "$path\Device Configurations" -File foreach ($deviceConfiguration in $deviceConfigurations) { $deviceConfigurationContent = Get-Content -LiteralPath $deviceConfiguration.FullName -Raw $deviceConfigurationDisplayName = ($deviceConfigurationContent | ConvertFrom-Json).displayName # Remove properties that are not available for creating a new configuration $requestBodyObject = $deviceConfigurationContent | ConvertFrom-Json # Set SupportsScopeTags to $false, because $true currently returns an HTTP Status 400 Bad Request error. if ($requestBodyObject.supportsScopeTags) { $requestBodyObject.supportsScopeTags = $false } $requestBodyObject.PSObject.Properties | Foreach-Object { if ($null -ne $_.Value) { if ($_.Value.GetType().Name -eq "DateTime") { $_.Value = (Get-Date -Date $_.Value -Format s) + "Z" } } } $requestBody = $requestBodyObject | Select-Object -Property * -ExcludeProperty id, createdDateTime, lastModifiedDateTime, version | ConvertTo-Json -Depth 100 # Restore the device configuration try { $null = Invoke-MSGraphRequest -HttpMethod POST -Content $requestBody.toString() -Url "deviceManagement/deviceConfigurations" -ErrorAction Stop [PSCustomObject]@{ "Action" = "Restore" "Type" = "Device Configuration" "Name" = $deviceConfigurationDisplayName "Path" = "Device Configurations\$($deviceConfiguration.Name)" } } catch { Write-Verbose "$deviceConfigurationDisplayName - Failed to restore Device Configuration" -Verbose Write-Error $_ -ErrorAction Continue } } } |