Public/Set-ADTPowerShellCulture.ps1
|
#----------------------------------------------------------------------------- # # MARK: Set-ADTPowerShellCulture # #----------------------------------------------------------------------------- function Set-ADTPowerShellCulture { <# .SYNOPSIS Changes the current thread's Culture and UICulture to the specified culture. .DESCRIPTION This function changes the current thread's Culture and UICulture to the specified culture. .PARAMETER CultureInfo The culture to set the current thread's Culture and UICulture to. Can be a CultureInfo object, or any valid IETF BCP 47 language tag. .EXAMPLE Set-ADTPowerShellCulture -Culture en-US .INPUTS None You cannot pipe objects to this function. .OUTPUTS None This function does not generate any output. .NOTES An active ADT session is NOT required to use this function. Tags: psadt Website: https://psappdeploytoolkit.com Copyright: (C) 2024 PSAppDeployToolkit Team (Sean Lillis, Dan Cunningham, Muhammad Mashwani, Mitch Richters, Dan Gough). License: https://opensource.org/license/lgpl-3-0 .LINK https://psappdeploytoolkit.com #> [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [System.Globalization.CultureInfo]$CultureInfo ) begin { # Initialize function. Initialize-ADTFunction -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState $smaCultureResolver = [System.Reflection.Assembly]::Load('System.Management.Automation').GetType('Microsoft.PowerShell.NativeCultureResolver') $smaResolverFlags = [System.Reflection.BindingFlags]::NonPublic -bor [System.Reflection.BindingFlags]::Static [System.Globalization.CultureInfo[]]$validCultures = (Get-WinUserLanguageList).LanguageTag } process { try { try { # Test that the specified culture is installed or not. if (!$validCultures.Contains($CultureInfo)) { $naerParams = @{ Exception = [System.ArgumentException]::new("The language pack for [$CultureInfo] is not installed on this system.", $CultureInfo) Category = [System.Management.Automation.ErrorCategory]::InvalidArgument ErrorId = 'CultureNotInstalled' TargetObject = $validCultures RecommendedAction = "Please review the installed cultures within this error's TargetObject and try again." } throw (New-ADTErrorRecord @naerParams) } # Reflectively update the culture to the specified value. # This will change PowerShell, but not its default variables like $PSCulture and $PSUICulture. $smaCultureResolver.GetField('m_Culture', $smaResolverFlags).SetValue($null, $CultureInfo) $smaCultureResolver.GetField('m_uiCulture', $smaResolverFlags).SetValue($null, $CultureInfo) } catch { # Re-writing the ErrorRecord with Write-Error ensures the correct PositionMessage is used. Write-Error -ErrorRecord $_ } } catch { # Process the caught error, log it and throw depending on the specified ErrorAction. Invoke-ADTFunctionErrorHandler -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState -ErrorRecord $_ } } end { # Finalize function. Complete-ADTFunction -Cmdlet $PSCmdlet } } |