Public/New-IntuneWin32AppRequirementRule.ps1
|
function New-IntuneWin32AppRequirementRule { <# .SYNOPSIS Construct a new requirement rule as an optional requirement for Add-IntuneWin32App cmdlet. .DESCRIPTION Construct a new requirement rule as an optional requirement for Add-IntuneWin32App cmdlet. .PARAMETER Architecture Specify the architecture as a requirement for the Win32 app. .PARAMETER MinimumSupportedWindowsRelease Specify the minimum supported Windows release version as a requirement for the Win32 app. .PARAMETER MinimumFreeDiskSpaceInMB Specify the minimum free disk space in MB as a requirement for the Win32 app. .PARAMETER MinimumMemoryInMB Specify the minimum required memory in MB as a requirement for the Win32 app. .PARAMETER MinimumNumberOfProcessors Specify the minimum number of required logical processors as a requirement for the Win32 app. .PARAMETER MinimumCPUSpeedInMHz Specify the minimum CPU speed in Mhz (as an integer) as a requirement for the Win32 app. .NOTES Author: Nickolaj Andersen Contact: @NickolajA Created: 2020-01-27 Updated: 2022-10-02 Version history: 1.0.0 - (2020-01-27) Function created 1.0.1 - (2021-03-22) Added new minimum supported operating system versions to parameter validation 1.0.2 - (2021-08-31) Added new minimum supported operating system versions to parameter validation 1.0.3 - (2022-09-02) minimumSupportedOperatingSystem property is replaced by minimumSupportedWindowsRelease 1.0.4 - (2022-10-02) minimumFreeDiskSpaceInMB, MinimumMemoryInMB, MinimumNumberOfProcessors and minimumCpuSpeedInMHz now adds a 'null' string #> [CmdletBinding(SupportsShouldProcess = $true)] param( [parameter(Mandatory = $true, HelpMessage = "Specify the architecture as a requirement for the Win32 app.")] [ValidateNotNullOrEmpty()] [ValidateSet("x64", "x86", "All")] [string]$Architecture, [parameter(Mandatory = $true, HelpMessage = "Specify the minimum supported Windows release version as a requirement for the Win32 app.")] [ValidateNotNullOrEmpty()] [ValidateSet("1607", "1703", "1709", "1803", "1809", "1903", "1909", "2004", "20H2", "21H1")] [string]$MinimumSupportedWindowsRelease, [parameter(Mandatory = $false, HelpMessage = "Specify the minimum free disk space in MB as a requirement for the Win32 app.")] [ValidateNotNullOrEmpty()] [int]$MinimumFreeDiskSpaceInMB, [parameter(Mandatory = $false, HelpMessage = "Specify the minimum required memory in MB as a requirement for the Win32 app.")] [ValidateNotNullOrEmpty()] [int]$MinimumMemoryInMB, [parameter(Mandatory = $false, HelpMessage = "Specify the minimum number of required logical processors as a requirement for the Win32 app.")] [ValidateNotNullOrEmpty()] [int]$MinimumNumberOfProcessors, [parameter(Mandatory = $false, HelpMessage = "Specify the minimum CPU speed in Mhz (as an integer) as a requirement for the Win32 app.")] [ValidateNotNullOrEmpty()] [int]$MinimumCPUSpeedInMHz ) Process { # Construct table for supported architectures $ArchitectureTable = @{ "x64" = "x64" "x86" = "x86" "All" = "x64,x86" } # Construct table for supported operating systems $OperatingSystemTable = @{ "1607" = "1607" "1703" = "1703" "1709" = "1709" "1803" = "1803" "1809" = "1809" "1903" = "1903" "1909" = "1909" "2004" = "2004" "20H2" = "2H20" "21H1" = "21H1" } # Construct ordered hash-table with least amount of required properties for default requirement rule $RequirementRule = [ordered]@{ "applicableArchitectures" = $ArchitectureTable[$Architecture] "minimumSupportedWindowsRelease" = $OperatingSystemTable[$MinimumSupportedWindowsRelease] } # Add additional requirement rule details if specified on command line if ($PSBoundParameters["MinimumFreeDiskSpaceInMB"]) { $RequirementRule.Add("minimumFreeDiskSpaceInMB", $MinimumFreeDiskSpaceInMB) } else { $RequirementRule.Add("minimumFreeDiskSpaceInMB", "null") } if ($PSBoundParameters["MinimumMemoryInMB"]) { $RequirementRule.Add("minimumMemoryInMB", $MinimumMemoryInMB) } else { $RequirementRule.Add("minimumMemoryInMB", "null") } if ($PSBoundParameters["MinimumNumberOfProcessors"]) { $RequirementRule.Add("minimumNumberOfProcessors", $MinimumNumberOfProcessors) } else { $RequirementRule.Add("minimumNumberOfProcessors", "null") } if ($PSBoundParameters["MinimumCPUSpeedInMHz"]) { $RequirementRule.Add("minimumCpuSpeedInMHz", $MinimumCPUSpeedInMHz) } else { $RequirementRule.Add("minimumCpuSpeedInMHz", "null") } return $RequirementRule } } |