Bitness/Bitness.psm1
#region Copyright & License # Copyright © 2020 - 2020 François Chabot # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. #endregion Set-StrictMode -Version Latest <# .SYNOPSIS Ensures the current process is 32 bit. .DESCRIPTION This command will throw if the current process is not a 32 bit process and will silently complete otherwise. .EXAMPLE PS> Assert-32bitProcess .EXAMPLE PS> Assert-32bitProcess -Verbose With the -Verbose switch, this command will confirm this process is 32 bit. .NOTES © 2020 be.stateless. #> function Assert-32bitProcess { [CmdletBinding()] [OutputType([void])] param() Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState if (-not(Test-32bitProcess)) { throw "A 32 bit process is required to run this function!" } Write-Verbose "Process is 32 bit." } <# .SYNOPSIS Ensures the current process is 64 bit. .DESCRIPTION This command will throw if the current process is not a 64 bit process and will silently complete otherwise. .EXAMPLE PS> Assert-64bitProcess .EXAMPLE PS> Assert-64bitProcess -Verbose With the -Verbose switch, this command will confirm this process is 64 bit. .NOTES © 2020 be.stateless. #> function Assert-64bitProcess { [CmdletBinding()] [OutputType([void])] param() Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState if (-not(Test-64bitProcess)) { throw "A 64 bit process is required to run this function!" } Write-Verbose "Process is 64 bit." } <# .SYNOPSIS Returns whether the current operating system is 32 bit. .DESCRIPTION This command will return $true if the current operating system is 32 bit, or $false otherwise. .EXAMPLE PS> Test-32bitArchitecture .NOTES © 2020 be.stateless. #> function Test-32bitArchitecture { [CmdletBinding()] [OutputType([bool])] param() Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState # https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/cim-processor [bool](Get-CimInstance -ClassName CIM_Processor | Where-Object AddressWidth -eq 32) } <# .SYNOPSIS Returns whether the current process is 32 bit. .DESCRIPTION This command will return $true if the current process is 32 bit, or $false otherwise. .EXAMPLE PS> Test-32bitProcess .NOTES © 2020 be.stateless. #> function Test-32bitProcess { [CmdletBinding()] [OutputType([bool])] param() # https://docs.microsoft.com/en-us/dotnet/api/system.intptr.size [System.IntPtr]::Size -eq 4 } <# .SYNOPSIS Returns whether the current operating system is 64 bit. .DESCRIPTION This command will return $true if the current operating system is 64 bit, or $false otherwise. .EXAMPLE PS> Test-64bitArchitecture .NOTES © 2020 be.stateless. #> function Test-64bitArchitecture { [CmdletBinding()] [OutputType([bool])] param() Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState # https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/cim-processor [bool](Get-CimInstance -ClassName CIM_Processor | Where-Object AddressWidth -eq 64) } <# .SYNOPSIS Returns whether the current process is 64 bit. .DESCRIPTION This command will return $true if the current process is 64 bit, or $false otherwise. .EXAMPLE PS> Test-64bitProcess .NOTES © 2020 be.stateless. #> function Test-64bitProcess { [CmdletBinding()] [OutputType([bool])] param() # https://docs.microsoft.com/en-us/dotnet/api/system.intptr.size [System.IntPtr]::Size -eq 8 } # SIG # Begin signature block # MIITugYJKoZIhvcNAQcCoIITqzCCE6cCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQU/M1XZuDAz8lJh53FZ2YHi5Xb # z+eggg46MIID7jCCA1egAwIBAgIQfpPr+3zGTlnqS5p31Ab8OzANBgkqhkiG9w0B # AQUFADCBizELMAkGA1UEBhMCWkExFTATBgNVBAgTDFdlc3Rlcm4gQ2FwZTEUMBIG # A1UEBxMLRHVyYmFudmlsbGUxDzANBgNVBAoTBlRoYXd0ZTEdMBsGA1UECxMUVGhh # d3RlIENlcnRpZmljYXRpb24xHzAdBgNVBAMTFlRoYXd0ZSBUaW1lc3RhbXBpbmcg # Q0EwHhcNMTIxMjIxMDAwMDAwWhcNMjAxMjMwMjM1OTU5WjBeMQswCQYDVQQGEwJV # UzEdMBsGA1UEChMUU3ltYW50ZWMgQ29ycG9yYXRpb24xMDAuBgNVBAMTJ1N5bWFu # dGVjIFRpbWUgU3RhbXBpbmcgU2VydmljZXMgQ0EgLSBHMjCCASIwDQYJKoZIhvcN # AQEBBQADggEPADCCAQoCggEBALGss0lUS5ccEgrYJXmRIlcqb9y4JsRDc2vCvy5Q # WvsUwnaOQwElQ7Sh4kX06Ld7w3TMIte0lAAC903tv7S3RCRrzV9FO9FEzkMScxeC # i2m0K8uZHqxyGyZNcR+xMd37UWECU6aq9UksBXhFpS+JzueZ5/6M4lc/PcaS3Er4 # ezPkeQr78HWIQZz/xQNRmarXbJ+TaYdlKYOFwmAUxMjJOxTawIHwHw103pIiq8r3 # +3R8J+b3Sht/p8OeLa6K6qbmqicWfWH3mHERvOJQoUvlXfrlDqcsn6plINPYlujI # fKVOSET/GeJEB5IL12iEgF1qeGRFzWBGflTBE3zFefHJwXECAwEAAaOB+jCB9zAd # BgNVHQ4EFgQUX5r1blzMzHSa1N197z/b7EyALt0wMgYIKwYBBQUHAQEEJjAkMCIG # CCsGAQUFBzABhhZodHRwOi8vb2NzcC50aGF3dGUuY29tMBIGA1UdEwEB/wQIMAYB # Af8CAQAwPwYDVR0fBDgwNjA0oDKgMIYuaHR0cDovL2NybC50aGF3dGUuY29tL1Ro # YXd0ZVRpbWVzdGFtcGluZ0NBLmNybDATBgNVHSUEDDAKBggrBgEFBQcDCDAOBgNV # HQ8BAf8EBAMCAQYwKAYDVR0RBCEwH6QdMBsxGTAXBgNVBAMTEFRpbWVTdGFtcC0y # MDQ4LTEwDQYJKoZIhvcNAQEFBQADgYEAAwmbj3nvf1kwqu9otfrjCR27T4IGXTdf # plKfFo3qHJIJRG71betYfDDo+WmNI3MLEm9Hqa45EfgqsZuwGsOO61mWAK3ODE2y # 0DGmCFwqevzieh1XTKhlGOl5QGIllm7HxzdqgyEIjkHq3dlXPx13SYcqFgZepjhq # IhKjURmDfrYwggSjMIIDi6ADAgECAhAOz/Q4yP6/NW4E2GqYGxpQMA0GCSqGSIb3 # DQEBBQUAMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBDb3Jwb3Jh # dGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2aWNlcyBD # QSAtIEcyMB4XDTEyMTAxODAwMDAwMFoXDTIwMTIyOTIzNTk1OVowYjELMAkGA1UE # BhMCVVMxHTAbBgNVBAoTFFN5bWFudGVjIENvcnBvcmF0aW9uMTQwMgYDVQQDEytT # eW1hbnRlYyBUaW1lIFN0YW1waW5nIFNlcnZpY2VzIFNpZ25lciAtIEc0MIIBIjAN # BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAomMLOUS4uyOnREm7Dv+h8GEKU5Ow # mNutLA9KxW7/hjxTVQ8VzgQ/K/2plpbZvmF5C1vJTIZ25eBDSyKV7sIrQ8Gf2Gi0 # jkBP7oU4uRHFI/JkWPAVMm9OV6GuiKQC1yoezUvh3WPVF4kyW7BemVqonShQDhfu # ltthO0VRHc8SVguSR/yrrvZmPUescHLnkudfzRC5xINklBm9JYDh6NIipdC6Anqh # d5NbZcPuF3S8QYYq3AhMjJKMkS2ed0QfaNaodHfbDlsyi1aLM73ZY8hJnTrFxeoz # C9Lxoxv0i77Zs1eLO94Ep3oisiSuLsdwxb5OgyYI+wu9qU+ZCOEQKHKqzQIDAQAB # o4IBVzCCAVMwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO # BgNVHQ8BAf8EBAMCB4AwcwYIKwYBBQUHAQEEZzBlMCoGCCsGAQUFBzABhh5odHRw # Oi8vdHMtb2NzcC53cy5zeW1hbnRlYy5jb20wNwYIKwYBBQUHMAKGK2h0dHA6Ly90 # cy1haWEud3Muc3ltYW50ZWMuY29tL3Rzcy1jYS1nMi5jZXIwPAYDVR0fBDUwMzAx # oC+gLYYraHR0cDovL3RzLWNybC53cy5zeW1hbnRlYy5jb20vdHNzLWNhLWcyLmNy # bDAoBgNVHREEITAfpB0wGzEZMBcGA1UEAxMQVGltZVN0YW1wLTIwNDgtMjAdBgNV # HQ4EFgQURsZpow5KFB7VTNpSYxc/Xja8DeYwHwYDVR0jBBgwFoAUX5r1blzMzHSa # 1N197z/b7EyALt0wDQYJKoZIhvcNAQEFBQADggEBAHg7tJEqAEzwj2IwN3ijhCcH # bxiy3iXcoNSUA6qGTiWfmkADHN3O43nLIWgG2rYytG2/9CwmYzPkSWRtDebDZw73 # BaQ1bHyJFsbpst+y6d0gxnEPzZV03LZc3r03H0N45ni1zSgEIKOq8UvEiCmRDoDR # EfzdXHZuT14ORUZBbg2w6jiasTraCXEQ/Bx5tIB7rGn0/Zy2DBYr8X9bCT2bW+IW # yhOBbQAuOA2oKY8s4bL0WqkBrxWcLC9JG9siu8P+eJRRw4axgohd8D20UaF5Mysu # e7ncIAkTcetqGVvP6KUwVyyJST+5z3/Jvz4iaGNTmr1pdKzFHTx/kuDDvBzYBHUw # ggWdMIIDUaADAgECAhAoE4COAwM7nkDtQn+T+DmdMEEGCSqGSIb3DQEBCjA0oA8w # DQYJYIZIAWUDBAIBBQChHDAaBgkqhkiG9w0BAQgwDQYJYIZIAWUDBAIBBQCiAwIB # IDAmMSQwIgYDVQQDDBtpY3JhZnRzb2Z0d2FyZUBzdGF0ZWxlc3MuYmUwHhcNMjAw # NjIzMTE0MzU2WhcNMjEwNjIzMTIwMzU2WjAmMSQwIgYDVQQDDBtpY3JhZnRzb2Z0 # d2FyZUBzdGF0ZWxlc3MuYmUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC # AQCZBxvQbCUEcEcEln280zwR7A3tP6eGxZVTRYGhacjDpQBP31HD3HlFx85BTaHG # oqZHWT6IjoH6p12lMLdUtIKED+aHU/ikIMOxl7JH/Sef+v8N7OEN7zHmNySNHzwp # JFyAOiHSQuOB+tOgOnH0S8FzBeY0koPAEha7lIG+TTht5Thc7s4eMGiDSQxofEJl # z0dxZ93MF58/59tXO7p/WPVaASpmf2yvUwva6UdF27br7nrEar1FkYm9fJjWZj4r # maoFwRP7VtXalmcGszcZz+GWa9OTCsLRkYEAstlZmqqktWsMJjl6gc/DYLSQDgnM # rhDWjbXyz7Bdu4NyNhEhmoFLAjx+LNH/gNL7p0SN9reTOzbP8yuQk6SEnTq2IxJG # vnm1fUNHw3BUt2I2pli+zjM/Zk1Ewwjy4UKOQ/9afWF8Gv4ZI+WB0urZMWKyFjam # Pk7VaUT+0LP4HRguE9Z19tUSnyQHd8YGxV/u7DhJMr/AMDUxhEgeKS3D4r2C11/R # 4hH11hf0IzCgM3ZM0srq+cJYyvNYV7kQ5Tf+iWNQGTJBPzfxrkDrAy5wZ67sLCN2 # KDKW3tQtpOCUvs5EjJpFvOSW3F37WhpDbWSOXh5/RkPaBYuPtvCtlH4pYJ+ZocWh # mVVEo0+1Jy7I6eKU8YZnpPtI27BXFJcVG1un5xB5rhTHFQIDAQABo18wXTAOBgNV # HQ8BAf8EBAMCB4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwFwYDVR0RBBAwDoIMc3Rh # dGVsZXNzLmJlMB0GA1UdDgQWBBSriwKgTYio3gri7A26JuOp3nI01DBBBgkqhkiG # 9w0BAQowNKAPMA0GCWCGSAFlAwQCAQUAoRwwGgYJKoZIhvcNAQEIMA0GCWCGSAFl # AwQCAQUAogMCASADggIBAFH3xqYukA0oWVzuY+WRpXhm1La5OZsnp06rPJYonbJO # a/tT3Krw90Qf2Y8mXFi8bI2DGoeihwq/VJ2OBiHbtIzykOex9TY2kRHor/ewgLLo # 6uH2+EL5TXwGn3dagsR7OiVoFwXRyjf+j4drM6+z/bMEU40UcyR5/3/cGKmbSx33 # m14ejne8spWIduNKagbFiy8kmJghMHhl6jrGBQCbBxSkvVOjrYtvdE8IMsplDmHw # ivTuedxXgcur7SoXf4b1jQhccm/pByv9dNMujQnzvsdGpLftYlyAXz7adtluo701 # W+nXgDidOql4MWbN7ANTfeGJm/O4scGP/86AuAZn2Uk/EK7S1XF8VZkg0eDVgene # UxoDDTRDe1v++FzmQToqXsWdedROy7iP69ShoUxaFh7OjKf2bisP7E1EhOtss9l1 # YBm9U4nx6GazBGF+IxnWenBuuTspTVROyYxLs8dERZLJQzbxaUwV/aK63xOVj8xX # 9p1QavYamoFaHGnkNGB+XW5qYqbbAWUKtrf+RF5WVCAL8Fuh3Yk6Ala3zMJs7icn # H58ljAz1EbvSH9Oa6rM/y4KGwe0pyCzZi1eZKbXYllqRdjgh+Uicjul10MSz1Q5+ # xZcOyqm+YVBlvCAZ414Sw+TcV2bUzMO1L08FcyTiMYZc3MSxVSDB/jbYe4NZ5f/i # MYIE6jCCBOYCAQEwOjAmMSQwIgYDVQQDDBtpY3JhZnRzb2Z0d2FyZUBzdGF0ZWxl # c3MuYmUCECgTgI4DAzueQO1Cf5P4OZ0wCQYFKw4DAhoFAKB4MBgGCisGAQQBgjcC # AQwxCjAIoAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYB # BAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFF8XNMjOdQcR # tjSnX5fhhYjJy7CPMA0GCSqGSIb3DQEBAQUABIICAE/LmAiuVESMvZDSTB4YFY+7 # t/I9WyoMTZ1yBgxYMFZDy3pfihJFPkMYSWpv/OKaR1vmS2cWfyFD22m07rpwHIvv # WBZPTiSj9CX4gn8ZfSaKPAsIHPJObi9v2cmFcvVSz6gG8HKN+SPyVrdP5ZGy8nz4 # 4MIm755q6l6a0+24yOuWO9btcdUCO8r8/A/DTyyvvMUuQ+J4XJ4izSYV2PgFBWwn # b/bibpt3k+P0Y8d5GmZ1fe+KbpLZYbONC8/ND4wXUEXIBGFHphN+n1yzPJLT/WAI # 14orJ0n0Zt3W0E8fDkJAGR/UjklIz2O4Fi1E57yOn2r67ty27IKp0cbyTKS//D90 # 9wxUbUOzhyElm6L5osX5rfFGt2cgYFGI0onUzGFNIWLdoicB2LBipz+v83MTmjGa # 46E7wbPEwhuBVrL2F685zJuX2F0dgVxO8ADh3RvxebLdAujQCKWz4/CxPFfKWkJ9 # pu4EZEv3fJ/Xvx5tqEYx8RxtzHF3LVk2I3rYfcAueZArtyharrKro07lzpt9UV4C # JRUCi9adtCAnuIp4Mjo4cPaQZpbXhnp45Mvvh7ioNeATK9PmNDm4N4AyLARkN3C9 # yICCbtdvIEfrY96VCfdi6PcA3rh7OnIq8XnB6LlVk2CZoqkHDJLzVrPHacU1JHxp # AVFTV6UemlsnFRKG3NpjoYICCzCCAgcGCSqGSIb3DQEJBjGCAfgwggH0AgEBMHIw # XjELMAkGA1UEBhMCVVMxHTAbBgNVBAoTFFN5bWFudGVjIENvcnBvcmF0aW9uMTAw # LgYDVQQDEydTeW1hbnRlYyBUaW1lIFN0YW1waW5nIFNlcnZpY2VzIENBIC0gRzIC # EA7P9DjI/r81bgTYapgbGlAwCQYFKw4DAhoFAKBdMBgGCSqGSIb3DQEJAzELBgkq # hkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIwMDYyMzE3MzMxMlowIwYJKoZIhvcN # AQkEMRYEFIIeJPwJSo2Xy/HkzscH3mmR0kOKMA0GCSqGSIb3DQEBAQUABIIBAFI0 # XWmUpDVNWDdAJ/Uz2b6FVLUN5lfRISfqTQqme8o5xb85+ooLr7hgJi21xbWYLM6W # 03ZFnMQa6rNoFcLjDJgIvd/6ow/03hOXmebmT+2svgS9fIugmEYv8KzrbsqNkY8R # wrD3aBVTO56geTYn0z5Z/0UxWJdrPDkhE7zW9/e0iVrxA2U2J0/P2DUYsMrI1Plf # kvjcRYbco6KfN7FR9FrEB9RaJINxB/yBT/+FY+ucbXoTlovXgbkIslQdcPXJwTVl # estb8N5v/Y7/tZoC9WHbfAi5ZkT/GFAZ7dcL3spS7vN9neLQXjmGAV5GSjOUvqLq # o4q8Cn2FPno3bLbUdOQ= # SIG # End signature block |